资产列表
基于游标分页获取用户资产余额。
接口信息
- 方法:
GET - 路径:
/api/v1/assets - 鉴权: 需要签名认证(详见 公共模块 · 签名说明)
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| cursor | query | integer | 否 | 游标,首次查询不传 |
| limit | query | integer | 否 | 每页数量,默认 20,最大 100 |
请求示例
GET /api/v1/assets?limit=50
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码 |
| message | string | 返回消息 |
| data.has_more | boolean | 是否有更多 |
| data.next_cursor | integer | 下一页游标 |
| data.assets | array | 资产列表 |
| data.assets[].id | integer | 主键 ID |
| data.assets[].user_id | integer | 用户 ID |
| data.assets[].asset | string | 资产类型,如 BTC、USDT |
| data.assets[].available | string | 可用余额 |
| data.assets[].frozen | string | 冻结余额 |
| data.assets[].updated_at | integer | 更新时间(毫秒) |
响应示例
{
"code": 0,
"message": "success",
"data": {
"has_more": false,
"next_cursor": 42,
"assets": [
{
"id": 1,
"user_id": 100001,
"asset": "USDT",
"available": "1000.5",
"frozen": "50",
"updated_at": 1704067200000
}
]
}
}