Get Address Information (v2)¶
This is the V2 address detail endpoint. Unlike V1, the coin_name parameter is optional. When omitted, the endpoint returns balances for all assets held at the address. We recommend using V2 for all new integrations.
Endpoint¶
Request¶
Path Parameters¶
| Field | Type | Description |
|---|---|---|
| b_id Required | String | Business line ID |
| wallet_code Required | String | Wallet ID |
| address Required | String | On-chain address to query |
Query Parameters¶
| Field | Type | Description |
|---|---|---|
| coin_name Optional | String | Filter by specific coin or token. If omitted, returns all assets held at the address. Allowed values: Refer to Coin Name (API) column in Supported Token |
Response¶
Response Body¶
| Field | Type | Description |
|---|---|---|
| code | Integer | Response code (0 = success) |
| message | String | Response message |
| successful | Boolean | Whether the request was successful |
| data | Array | List of asset balances at the address (see details below) |
data (array of objects)
Each item in data:
| Field | Type | Description |
|---|---|---|
| chain | String | Blockchain network (e.g. TRON, SOL, ETH) |
| coin_name | String | Asset name |
| address | String | On-chain address |
| address_type | String | Address type. Values: NORMAL_ADDRESS, CONSOLIDATED_ADDRESS |
| address_storage | String | Storage type. Values: HOT, COLD |
| description | String | Address description |
| total_amount | Decimal | Total balance (in smallest unit) |
| total_amount_str | String | Total balance in string format (in smallest unit) |
| freeze_amount | Decimal | Frozen/locked amount (in smallest unit) |
| freeze_amount_str | String | Frozen/locked amount in string format (in smallest unit) |
| available_amount | Decimal | Withdrawable balance (in smallest unit) |
| available_amount_str | String | Withdrawable balance in string format (in smallest unit) |
Response Example¶
{
"code": 0,
"message": "",
"successful": true,
"data": [
{
"chain": "TRON",
"coin_name": "USDTTRC",
"address": "TJDaZuYJKdSSmDcz5wxifsVjrQsGNLk8bm",
"address_type": "NORMAL_ADDRESS",
"address_storage": "HOT",
"description": "",
"total_amount": 87500000,
"total_amount_str": "87500000",
"freeze_amount": 0,
"freeze_amount_str": "0",
"available_amount": 87500000,
"available_amount_str": "87500000"
},
{
"chain": "TRON",
"coin_name": "TRX",
"address": "TJDaZuYJKdSSmDcz5wxifsVjrQsGNLk8bm",
"address_type": "NORMAL_ADDRESS",
"address_storage": "HOT",
"description": "",
"total_amount": 62370,
"total_amount_str": "62370",
"freeze_amount": 0,
"freeze_amount_str": "0",
"available_amount": 62370,
"available_amount_str": "62370"
},
{
"chain": "TRON",
"coin_name": "USDC_TRC",
"address": "TJDaZuYJKdSSmDcz5wxifsVjrQsGNLk8bm",
"address_type": "NORMAL_ADDRESS",
"address_storage": "HOT",
"description": "",
"total_amount": 0,
"total_amount_str": "0",
"freeze_amount": 0,
"freeze_amount_str": "0",
"available_amount": 0,
"available_amount_str": "0"
}
]
}