跳转至

申请地址

用于申请地址隔离账户温存储,冷存储的地址。

要查询某个钱包已使用的地址数量及其地址上限,请使用 查询单个钱包详情 API。\ 要查询整个企业已使用的地址数量及剩余额度,请使用 查询剩余地址数 API。\ 当钱包额度或企业额度达到上限时,将无法继续创建地址。

请求

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

参数

路径参数

字段类型描述
b_id
必填
String业务线ID
wallet_code
必填
String钱包ID

请求体参数

字段类型描述
address_num
必填
Integer申请的地址数量(单次最多申请50个地址)
address_type
必填
Enum地址类型
允许值:NORMAL_ADDRESS
coin_name
可选
String币种名称
允许值:参考 支持的代币 中的 Coin Name (API) 列
apply_id
可选
String传入相同ID会返回相同结果以避免重复(最多50个字符)
description
可选
String地址备注 (最多200个字符)。一次申请多个地址时,该备注会应用到本次生成的所有地址。

对于以太坊多签和波场多签冷钱包,API 仅会创建1个地址,无论 address_num 的值是多少,并且不会在响应中返回地址。您需要查询地址列表API以获取新地址。

请求体示例

request.json
{
    "address_num": 2,
    "address_type": "NORMAL_ADDRESS",
    "coin_name": "ETH",
    "apply_id": "unique-request-id-12345",
    "description": "客户充值地址"
}

响应

响应体

字段 类型 描述
code Integer 响应代码(0 = 成功)
message String 响应消息
successful Boolean 请求是否成功
data String[] 所有新创建的地址列表

响应示例

{
    "code": 0,
    "message": "",
    "data": ["mkAbCEHS1d8QZfYveiU6YEhDbCGp2Cky9v", "mn4FFTQqs6VxE1ADCBg7jZS6t6J6sLRhKQ"],
    "successful": true
}