Batch Get Asset Balances
Query balances in batch by specified asset names. Assets not held will return a balance of 0.
API Information
- Method:
GET - Path:
/api/v1/assets/batch - Authentication: Requires signature authentication (see Common Module · Signature Specification)
Request Parameters
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| assets | query | string | Yes | Comma-separated asset list, e.g. BTC,USDT,ETH |
Request Example
GET /api/v1/assets/batch?assets=BTC,USDT,ETH
Response Fields
| Field | Type | Description |
|---|---|---|
| code | integer | Status code |
| message | string | Response message |
| data.assets | array | Asset list (unheld assets have balance of 0) |
| data.assets[].id | integer | Primary key ID |
| data.assets[].user_id | integer | User ID |
| data.assets[].asset | string | Asset type |
| data.assets[].available | string | Available balance |
| data.assets[].frozen | string | Frozen balance |
| data.assets[].updated_at | integer | Update time (milliseconds) |
Response Example
{
"code": 0,
"message": "success",
"data": {
"assets": [
{
"id": 1,
"user_id": 100001,
"asset": "USDT",
"available": "1000.5",
"frozen": "50",
"updated_at": 1704067200000
}
]
}
}