查询地址列表

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

请求

GET https://custody-example-url/custody/v1/api/projects/{b_id}/wallets/{wallet_code}/addresses

参数

字段 类型 描述
b_id String 业务线id
wallet_code String 钱包编号
coin_name 可选 String 币种,查询归一钱包资产
允许值: 参考币种列表Symbol (For API)
hide_no_coin_address 可选 String 是否隐藏无币地址,默认为false
允许值: true, false
key_word 可选 String 地址或描述关键字
offset 可选 String offset,如果不传表示查询全部
limit 可选 String limit,如果不传表示查询全部
sort_by_balance 可选 String 按照地址的余额排序
允许值: DESC, ASC
min_balance 可选 Integer 只返回余额 >= min_balance 的地址
max_balance 可选 Integer 只返回余额 <= max_balance 的地址
manage_wallet_address 可选 Boolean 为true时查询ETH管理地址,false则查询冷地址列表,该参数默认为false

响应

字段 类型 描述
code Integer 响应状态码
message String 响应信息
successful Boolean 请求是否成功
data Object 地址列表数据
offset Integer offset
limit Integer limit
list Object[] 地址列表
domain_id String 企业domainId
b_id String 业务线id
wallet_code String 钱包编号
wallet_type String 钱包类型(MIXED_ADDRESS-地址混用 SEGREGATED_ADDRESS-地址隔离)
address String 钱包名称
address_type String 地址类型(NORMAL_ADDRESS-普通地址/入金地址)
address_storage String 地址冷热类型 COLD/HOT
coin_name String 币种名称
bch_address_format String BCH地址格式,CashAdd/Legacy(仅BCH有)
description Decimal 地址描述
freeze_amount Decimal 冻结数币数量(最小单位)(针对地址隔离钱包)
total_amount Decimal 总的数币数量(最小单位)

响应示例

{
  "code": 0,
  "message": "",
  "successful": true,
  "data": {
    "limit": 0,
    "offset": 1,
    "total": 1,
    "list": [
      {
        "address": "mnVFMBnsMJ7goypJFS8A6nWgq4cN1TzxXb",
        "address_storage": "COLD",
        "address_type": "NORMAL_ADDRESS",
        "available_amount": null,
        "coin_name": "BTC",
        "bch_address_format": null,
        "b_id": "4a3e2fb40faa4b9d94480559ac01e8de",
        "description": "test addressss",
        "domain_id": "e4c9f9024bff472cba51cb2a9fe0f974",
        "freeze_amount": null,
        "total_amount": 0,
        "wallet_code": "CHBTC2656037244",
        "wallet_type": "MIXED_ADDRESS"
      }
    ]
  }
}
Copyright © 2025 Cactus Custody all right reserved,powered by GitbookUpdated: 17-Apr-2025 10:11:15

results matching ""

    No results matching ""

    results matching ""

      No results matching ""