查询充值地址列表

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

返回钱包下已生成的充值地址与余额。复用钱包详情里的 addresses,不另发渠道请求。

鉴权

bearerAuth
header鉴权Bearer <令牌>

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

路径参数

walletId*string

钱包 ID,如 wlt_xyz789。

查询参数

providerCustomerId*string

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

Header 参数

X-Channel-Provider*string

渠道提供商标识,如 GLDB

响应体

返回充值地址列表。

application/json
  1. response
code?integer

业务状态码

message?string
traceId?string

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

data?array<>

充值地址列表

请求示例
curl -X GET 'https://api.test.stabofx.com/openapi/v1/digital-wallets/wlt_xyz789/addresses?providerCustomerId=usr_user123' \  -H 'X-Channel-Provider: GLDB'
响应示例
{  "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": "1000.500000",      "lockedBalance": "0.000000",      "availableBalance": "1000.500000"    }  ]}