批量获取资产余额
按指定资产名称批量查询余额,未持有的资产余额返回 0。
接口信息
- 方法:
GET - 路径:
/api/v1/assets/batch - 鉴权: 需要签名认证(详见 公共模块 · 签名说明)
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| assets | query | string | 是 | 逗号分隔的资产列表,如 BTC,USDT,ETH |
请求示例
GET /api/v1/assets/batch?assets=BTC,USDT,ETH
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码 |
| message | string | 返回消息 |
| data.assets | array | 资产列表(未持有的余额为 0) |
| data.assets[].id | integer | 主键 ID |
| data.assets[].user_id | integer | 用户 ID |
| data.assets[].asset | string | 资产类型 |
| data.assets[].available | string | 可用余额 |
| data.assets[].frozen | string | 冻结余额 |
| data.assets[].updated_at | integer | 更新时间(毫秒) |
响应示例
{
"code": 0,
"message": "success",
"data": {
"assets": [
{
"id": 1,
"user_id": 100001,
"asset": "USDT",
"available": "1000.5",
"frozen": "50",
"updated_at": 1704067200000
}
]
}
}