查询充值地址列表
GET
返回钱包下已生成的充值地址与余额。复用钱包详情里的 addresses,不另发渠道请求。
bearerAuthheader
鉴权Bearer <令牌>通过 POST /oauth2/token 获取的 access_token。请求头格式为 Authorization: Bearer {accessToken}。
walletId*string钱包 ID,如 wlt_xyz789。
providerCustomerId*string渠道侧客户标识,由调用方传入。Legend 即 user_short_id。
X-Channel-Provider*string渠道提供商标识,如 GLDB
返回充值地址列表。
application/json- response
code?integer业务状态码
message?stringtraceId?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" } ]}