跳转至

查询单个钱包详情

请求

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

请求参数

路径参数

字段 类型 描述

b_id
必填

String 业务线 ID

wallet_code
必填

String 钱包 ID

查询参数

字段 类型 描述

coin_name
可选

String

资产名称
允许值:参考 支持的代币 中的 Coin Name (API) 列


响应

响应体说明

字段类型描述
codeInteger响应码(0 = 成功)
messageString响应消息
successfulBoolean请求是否成功
dataObject以下是 data 对象内的项目列表

data(对象)

字段类型描述
domain_idString域 ID
bidString业务线 ID
business_nameString业务线名称
wallet_codeString钱包 ID
main_wallet_codeString主钱包 ID
main_walletBoolean是否为主钱包
manage_walletBoolean是否为管理钱包。适用于 ETH 多签冷钱包,该类钱包区分冷地址和管理地址。True 表示管理地址,False 表示普通冷地址。
wallet_nameString钱包名称
coin_nameString资产名称
chainString链名称(仅适用于 DeFi 钱包)
contract_addressString合约地址
wallet_typeString钱包类型。
允许值:
- SEGREGATED_ADDRESS(地址隔离)
- DAPP_ADDRESS(DeFi 合约钱包)
- DAPP_CUSTOM_ADDRESS(DeFi 自定义钱包)
- MIXED_ADDRESS(地址混用)
storage_typeString存储类型。
允许值:
- PRIME_HOT(Prime 热存储)
- PRIME_COLD_LV1(Prime 冷存储 Lv1)
available_amountDecimal可用金额(最小单位)
available_amount_strString可用金额(最小单位)(字符串格式)
freeze_amountDecimal冻结金额(最小单位)
freeze_amount_strString冻结金额(最小单位)(字符串格式)
total_amountDecimal总资产金额(最小单位)
total_amount_strString总资产金额(最小单位)(字符串格式)
usd_total_marketDecimal总市值(美元)
usd_total_market_strString总市值(美元)(字符串格式)
cny_total_marketDecimal总市值(人民币)
cny_total_market_strString总市值(人民币)(字符串格式)
coin_statusString资产状态。允许值:
- 1(正常)
- 2(仅限制提币)
- 3(仅限制存币)
- 4(限制存币提币)
reason_of_statusString资产状态说明
is_consolidatedBoolean是否为归集钱包
normal_address_limitInteger地址数量上限
normal_address_numInteger已申请的地址数量
consolidated_address_limitInteger归集地址数量上限
consolidated_address_numInteger已申请的归集地址数量
create_timeLong钱包创建时间(毫秒时间戳)
fingerprintString用于唯一标识 Cardano (ADA) 区块链上原生代币的用户友好型资产标识符。
max_withdraw_amountDecimal该钱包可提币的最大金额。
max_withdraw_amount_strString该钱包可提币的最大金额(字符串格式)

响应示例

{
  "code": 0,
  "message": "",
  "successful": true,
  "data": {
    "domain_id": "1e2fa188f5d44faca64c45485062e829",
    "bid": "b4a25892d06542ba8fedb40e99d0c659",
    "business_name": "FOR API TEST",
    "wallet_code": "CHEVMS5368231134",
    "main_wallet_code": "CHEVMS5368231134",
    "main_wallet": true,
    "manage_wallet": false,
    "wallet_name": "",
    "coin_name": "USDC",
    "chain": "ETH",
    "contract_address": "0x43c7181e745be7265eb103c5d69f1b7b4ef8763f",
    "wallet_type": "MIXED_ADDRESS",
    "storage_type": "PRIME_HOT",
    "available_amount": 0,
    "available_amount_str": "0",
    "freeze_amount": 0,
    "freeze_amount_str": "0",
    "total_amount": 0,
    "total_amount_str": "0",
    "usd_total_market": 0,
    "usd_total_market_str": "0.0000",
    "cny_total_market": 0,
    "cny_total_market_str": "0.0000",
    "coin_status": "1",
    "reason_of_status": "",
    "is_consolidated": false,
    "normal_address_limit": 30,
    "normal_address_num": 10,
    "consolidated_address_limit": null,
    "consolidated_address_num": null,
    "create_time": 1757494284000,
    "fingerprint": null
  }
}