跳转至

查询地址列表 (v2)

获取地址列表 V2 返回精简的地址级别元数据。如需查询特定地址的资产余额,请使用获取地址详情 (v2)。建议所有新集成使用 V2 版本。

请求

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

参数

路径参数

字段类型说明
b_id
必填
String业务线 ID
wallet_code
必填
String钱包编号

查询参数

字段类型说明
offset
可选
Integer分页偏移量,不可小于 0。默认值:0
limit
可选
Integer每页返回数量。最大值:1000。默认值:10

响应

响应体

字段类型说明
codeInteger响应码(0 = 成功)
messageString响应信息
successfulBoolean请求是否成功
dataObject数据对象(详见下方 data 说明)

data(对象)

字段类型说明
offsetInteger分页偏移量
limitInteger分页限制
totalInteger地址总数
listArray地址列表(详见下方 list 说明)

list(对象数组)

list 中每个元素:

字段类型说明
addressString链上地址
address_typeString地址类型。值:NORMAL_ADDRESS, CONSOLIDATED_ADDRESS
descriptionString地址描述

响应示例

{
    "code": 0,
    "message": "",
    "successful": true,
    "data": {
        "offset": 0,
        "limit": 2,
        "list": [
            {
                "address": "TAKmMvdnBDuSYCH6iqWmqDSfMcdvk6bRdR",
                "address_type": "NORMAL_ADDRESS",
                "description": ""
            },
            {
                "address": "TCEnQ7PBdU3nHQRAWzYh3HkxumUEXVfAbM",
                "address_type": "NORMAL_ADDRESS",
                "description": ""
            }
        ],
        "total": 13,
        "metadata": null
    }
}