跳转至

查询单个地址 (v1)

用于查询地址隔离账户温存储,冷存储和DeFi账户地址,对于归一钱包,通过coin_name来查询该币种地址。

该接口已提供 V2 版本,具备更优的性能表现。我们建议所有新的集成使用 V2 版本。请参考查询单个地址 (v2)接口。

请求

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

参数

路径参数

字段类型描述
b_id
必填
String业务线ID
wallet_code
必填
String钱包ID
address
必填
String钱包地址

查询参数

字段类型描述
coin_name
可选
String币种名称
允许值:参考 支持的代币 中的 Coin Name(API) 列

响应

响应体

字段类型描述
codeInteger响应代码(0 = 成功)
messageString响应消息
successfulBoolean请求是否成功
dataObject地址信息列表

data (对象)

字段类型描述
domain_idString企业ID
bidString业务线ID
wallet_codeString钱包ID
main_wallet_codeString主钱包ID
wallet_nameString钱包名称
wallet_typeString钱包类型(MIXED_ADDRESS 或 SEGREGATED_ADDRESS)
wallet_address_typeString钱包地址类型
addressString地址
chainString链名称(例如 ETH、BTC)
address_typeString地址类型(NORMAL_ADDRESS)
address_storageString地址存储类型(COLD/HOT)
bch_address_formatStringBCH地址格式(CashAdd/Legacy)
btc_address_typeStringBTC地址类型(Legacy 或 SegWit)
coin_nameString资产名称
descriptionString地址描述
available_amountDecimal可用资产数量(最小单位)
available_amount_strString可用资产数量(最小单位)(字符串格式)
freeze_amountDecimal冻结资产数量(最小单位)
freeze_amount_strString冻结资产数量(最小单位)(字符串格式)
total_amountDecimal总资产数量(最小单位)
total_amount_strString总资产数量(最小单位)(字符串格式)
confirm_ratioString确认比率
total_market_amountDecimal总市值(美元)
total_market_amount_strString总市值(美元)(字符串格式)
cny_total_market_amountDecimal总市值(人民币)
cny_total_market_amount_strString总市值(人民币)(字符串格式)
address_statusString地址状态
is_third_party_black_addressBoolean该地址是否被标记为第三方黑名单地址
max_withdraw_amountDecimal该地址上此资产的最大可提币金额
max_withdraw_amount_strString该地址上此资产的最大可提币金(字符串格式)

响应示例

{
    "code": 0,
    "message": "",
    "successful": true,
    "data": {
        "domain_id": "1e2fa188f5d44faca64c45485062e829",
        "bid": "b4a25892d06542ba8fedb40e99d0c659",
        "wallet_code": "CHEVMS5368231134",
        "main_wallet_code": "CHEVMS5368231134",
        "wallet_name": "",
        "wallet_type": "MIXED_ADDRESS",
        "wallet_address_type": null,
        "address": "0xd514722Dc9f4407F0729bf8654436ee3100C192c",
        "chain": "ETH",
        "address_type": "NORMAL_ADDRESS",
        "address_storage": "HOT",
        "bch_address_format": null,
        "btc_address_type": null,
        "coin_name": "USDC",
        "description": "",
        "available_amount": 0,
        "available_amount_str": "0",
        "freeze_amount": 0,
        "freeze_amount_str": "0",
        "total_amount": 0,
        "total_amount_str": "0",
        "confirm_ratio": null,
        "total_market_amount": null,
        "total_market_amount_str": null,
        "cny_total_market_amount": null,
        "cny_total_market_amount_str": null,
        "address_status": null,
        "is_third_party_black_address": false
    }
}