跳转至

查询单个地址 (v2)

获取地址详情 V2 接口中,coin_name 参数为可选。未传入时,接口将返回该地址下所有资产的余额信息。建议所有新集成使用 V2 版本。

请求

GET https://api.mycactus.dev/custody/v2/api/projects/{b_id}/wallets/{wallet_code}/addresses/{address}
GET https://api.mycactus.com/custody/v2/api/projects/{b_id}/wallets/{wallet_code}/addresses/{address}

参数

路径参数

字段类型说明
b_id
必填
String业务线 ID
wallet_code
必填
String钱包编号
address
必填
String链上地址

查询参数

字段类型说明
coin_name
可选
String按币种筛选。若不传,则返回该地址下所有资产。
允许值: 参考支持的代币列表中的 Coin Name (API) 列

响应

响应体

字段类型说明
codeInteger响应码(0 = 成功)
messageString响应信息
successfulBoolean请求是否成功
dataArray资产余额列表(详见下方说明)

data(对象数组)

data 中每个元素:

字段类型说明
chainString区块链网络(如 TRON、SOL、ETH)
coin_nameString资产名称
addressString链上地址
address_typeString地址类型。值:NORMAL_ADDRESS, CONSOLIDATED_ADDRESS
address_storageString存储类型。值:HOT, COLD
descriptionString地址描述
total_amountDecimal总余额(最小精度单位)
total_amount_strString总余额(最小精度单位)(字符串格式)
freeze_amountDecimal冻结金额(最小精度单位)
freeze_amount_strString冻结金额(最小精度单位)(字符串格式)
available_amountDecimal可用余额(最小精度单位)
available_amount_strString可用余额(最小精度单位)(字符串格式)

响应示例

{
    "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"
        }
    ]
}