Skip to main content

Batch Get Asset Balances

Query balances in batch by specified asset names. Assets not held will return a balance of 0.

API Information

Request Parameters

ParameterLocationTypeRequiredDescription
assetsquerystringYesComma-separated asset list, e.g. BTC,USDT,ETH

Request Example

GET /api/v1/assets/batch?assets=BTC,USDT,ETH

Response Fields

FieldTypeDescription
codeintegerStatus code
messagestringResponse message
data.assetsarrayAsset list (unheld assets have balance of 0)
data.assets[].idintegerPrimary key ID
data.assets[].user_idintegerUser ID
data.assets[].assetstringAsset type
data.assets[].availablestringAvailable balance
data.assets[].frozenstringFrozen balance
data.assets[].updated_atintegerUpdate 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
}
]
}
}