开发者文档
官网控制台

生成充值地址

POST
/openapi/v1/digital-wallets/{walletId}/addresses

为已开通的数币钱包生成充值地址。钱包必须为 ACTIVE。渠道已有该资产地址时返回同一个 addressId。

幂等键走 Idempotency-Key 请求头。assetCode 来自资产列表查询，原样传回。

鉴权

bearerAuth
header鉴权Bearer <令牌>

通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。

路径参数

walletId*string

钱包 ID，如 wlt_xyz789。

Header 参数

X-Channel-Provider*string

渠道提供商标识，如 GLDB

Idempotency-Key*string

唯一请求标识，用于防止重复操作（建议使用 UUID）。有效期 24 小时。三个转账 POST、LEGEND 创建法币账户、创建数币钱包、生成充值地址，每次请求使用唯一的 Key。切勿为不同操作复用同一 Key。同一 Key 在有效期内再次提交会被拒绝。规则见 Payment 产品指南

请求体

application/json
  1. body
providerCustomerId*string

渠道侧客户标识，由调用方传入。Legend 即 user_short_id。

assetCode*string

资产码，来自资产列表查询，原样传回。最长 32 字符。

响应体

返回充值地址。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

请求追踪 ID。联系技术支持时请提供

data?

数币钱包充值地址。

请求示例
curl -X POST 'https://api.test.stabofx.com/openapi/v1/digital-wallets/wlt_xyz789/addresses' \  -H 'X-Channel-Provider: GLDB' \  -H 'Idempotency-Key: 7f3c2c0e-5b1a-4f6e-9d2a-0a1b2c3d4e5f' \  -H 'Content-Type: application/json' \  -d '{  "providerCustomerId": "usr_user123",  "assetCode": "USDT_TRON"}'
响应示例
{  "code": 200,  "message": "操作成功",  "traceId": "t_xxxxxxxx",  "data": {    "addressId": "adr_abc123",    "walletId": "wlt_xyz789",    "currency": "USDT",    "assetCode": "USDT_TRON",    "network": "Tron",    "address": "TYASr5UV6HEcXatwdFQiMrKxzKRDRbF",    "contractAddress": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",    "status": "ACTIVE",    "totalBalance": "0.000000",    "lockedBalance": "0.000000",    "availableBalance": "0.000000"  }}