申请地址¶
用于申请地址隔离账户温存储,冷存储的地址。
要查询某个钱包已使用的地址数量及其地址上限,请使用 查询单个钱包详情 API。\ 要查询整个企业已使用的地址数量及剩余额度,请使用 查询剩余地址数 API。\ 当钱包额度或企业额度达到上限时,将无法继续创建地址。
请求¶
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| 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[] | 所有新创建的地址列表 |