查询单个地址 (v2)¶
获取地址详情 V2 接口中,coin_name 参数为可选。未传入时,接口将返回该地址下所有资产的余额信息。建议所有新集成使用 V2 版本。
请求¶
参数¶
路径参数¶
| 字段 | 类型 | 说明 |
|---|---|---|
| b_id 必填 | String | 业务线 ID |
| wallet_code 必填 | String | 钱包编号 |
| address 必填 | String | 链上地址 |
查询参数¶
| 字段 | 类型 | 说明 |
|---|---|---|
| coin_name 可选 | String | 按币种筛选。若不传,则返回该地址下所有资产。 允许值: 参考支持的代币列表中的 Coin Name (API) 列 |
响应¶
响应体¶
| 字段 | 类型 | 说明 |
|---|---|---|
| code | Integer | 响应码(0 = 成功) |
| message | String | 响应信息 |
| successful | Boolean | 请求是否成功 |
| data | Array | 资产余额列表(详见下方说明) |
data(对象数组)
data 中每个元素:
| 字段 | 类型 | 说明 |
|---|---|---|
| chain | String | 区块链网络(如 TRON、SOL、ETH) |
| coin_name | String | 资产名称 |
| address | String | 链上地址 |
| address_type | String | 地址类型。值:NORMAL_ADDRESS, CONSOLIDATED_ADDRESS |
| address_storage | String | 存储类型。值:HOT, COLD |
| description | String | 地址描述 |
| total_amount | Decimal | 总余额(最小精度单位) |
| total_amount_str | String | 总余额(最小精度单位)(字符串格式) |
| freeze_amount | Decimal | 冻结金额(最小精度单位) |
| freeze_amount_str | String | 冻结金额(最小精度单位)(字符串格式) |
| available_amount | Decimal | 可用余额(最小精度单位) |
| available_amount_str | String | 可用余额(最小精度单位)(字符串格式) |
响应示例¶
{
"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"
}
]
}