查询钱包列表

请求

GET https://custody-example-url/custody/v1/api/wallets

参数

字段 类型 描述
b_id 可选 String 业务线id,如果不传表示查询公司下所有钱包
type 可选 String 冷热钱包类型:HOT或者COLD,如果不传表示不区分冷热钱包
允许值: HOT, COLD
hide_no_coin_wallet 可选 Boolean 是否隐藏无币钱包,如果不传表示不进行无币钱包过滤
允许值: true, false
coin_names 可选 String[] 币种名称,如果不传表示不进行币种过滤
允许值: 参考币种列表Symbol (For API)
wallet_types 可选 String[] 钱包类型列表,如果不传表示不进行钱包类型过滤
允许值: MIXED_ADDRESS, SEGREGATED_ADDRESS, DAPP_ADDRESS, DAPP_CUSTOM_ADDRESS
key_word 可选 String 钱包名称、钱包编号关键字
defi_wallet_code 可选 String DeFi钱包编号,查询DeFi钱包列表
main_wallet_code 可选 String 托管账户查询归一钱包
chain 可选 String 链信息,查询DeFi钱包时可选参数,查询DeFi钱包对应链的所有钱包,如果不传表示查询所有链
允许值: 参考币种列表Cactus Network Name (For API)
total_market_order 可选 Integer 总市值排序:0表示降序,1表示升序,总市值排序和创建时间排序二选一,如果都不传默认按照市值降序排序
允许值: 0, 1
create_time_order 可选 Integer 创建时间排序:0表示降序,1表示升序,总市值排序和创建时间排序二选一,如果都不传默认按照市值降序排序
允许值: 0, 1
offset 可选 Integer 如果不传,默认 0
limit 可选 Integer 如果不传,默认 10

响应

字段 类型 描述
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 钱包编号
main_wallet_code String DeFi主钱包编号,仅DeFi钱包
wallet_name String 钱包名称
coin_name String 币种名称
chain String 链信息,仅DeFi钱包
contract_address String 合约地址
wallet_type String 钱包类型(MIXED_ADDRESS-地址混用 SEGREGATED_ADDRESS-地址隔离 DAPP_ADDRESS-DeFi合约钱包 DAPP_CUSTOM_ADDRESS-DeFi自定义钱包)
storage_type String 存储类型(PRIME_HOT-prime热存储 PRIME_COLD_LV1-prime冷存储Lv1)
available_amount Decimal 可用数币数量(最小单位)
freeze_amount Decimal 冻结数币数量(最小单位)
total_amount Decimal 总的数币数量(最小单位)
usd_total_market Decimal 总市值(美元)
cny_total_market Decimal 总市值(人民币)
coin_status String 币种状态(1: 正常,2: 仅限制提币,3: 仅限制存币,4: 限制存币提币)
chinese_reason_of_status String 币种状态说明(中文)
english_reason_of_status String 币种状态说明(英文)
normal_address_limit Integer 该钱包可申请普通地址上限
normal_address_num Integer 该钱包已申请普通地址数量
create_time Long 钱包创建时间(时间戳)

响应示例

{
    "code": 0,
    "message": "",
    "successful": true,
    "data": {
        "offset": 0,
        "limit": 10,
        "list": [
            {
                "domain_id": "a5b3f782c4e24c688eca60946442a75f",
                "b_id": "ed70ff75b1fe4994a3bd836befe0e87f",
                "wallet_code": "CCLTC1278870318",
                "wallet_name": "test wallet",
                "coin_name": "LTC",
                "contract_address": null,
                "wallet_type": "SEGREGATED_ADDRESS",
                "storage_type": "PRIME_COLD",
                "available_amount": 0,
                "freeze_amount": 0,
                "total_amount": 0,
                "usd_total_market": 0.0,
                "cny_total_market": 0.0,
                "coin_status": "1",
                "chinese_reason_of_status": "",
                "english_reason_of_status": "",
                "normal_address_limit": 10,
                "normal_address_num": 2,
                "create_time": 1577762589000
            }
        ],
        "total": 1
    }
}
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 ""