查询地址列表
用于查询地址隔离账户温存储,冷存储和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"
}
]
}
}