# 3、查询收款钱包地址余额
请求方式
- POST
请求 URL
/api/v3/wallet/query/address
请求 Header
Content-Type: application/json;charset=utf-8
请求头参数
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
access_key | String | 商户后台获取 | pFqV75X3 |
timestamp | int64 | 13位时间戳(毫秒) | 1679724896223 |
nonce | String | 随机字符串(UUID V4) | 794c26b0-d33c-4394-b2bb-c485eca16d9e |
sign | String | 使用密钥生成的签名 | kAXyh+eerqrefyaF8dyFB0M4FVo= |
请求参数(JSON)
{
"address": "TYpFF2AjK82tcXEiJCwR2FPWsPPyaSiGQB"
}
参数说明
参数名 | 类型 | 描述 | 是否必填 |
---|---|---|---|
address | String | 钱包地址(TRON/ETH 等) | ✅ 是 |
响应类型
Header: {
"Content-Type": "application/json;charset=utf-8"
}
响应示例
{
"code": "200",
"success": true,
"msg": "成功",
"msgEn": "SUCCESS",
"data": {
"walletAddress": "TYpFF2AjK82tcXEiJCwR2FPWsPPyaSiGQB",
"merchant": "[email protected]",
"userFlagId": "WSXTES2",
"chainName": "TRON",
"amount": 20.4912,
"tokenList": [
{
"tokenName": "USDT",
"tokenAmount": 40
},
{
"tokenName": "TUSD",
"tokenAmount": 0
},
{
"tokenName": "USDC",
"tokenAmount": 0
}
]
}
}
响应参数说明
参数名 | 类型 | 描述 |
---|---|---|
walletAddress | String | 钱包地址 |
merchant | String | 商户信息 |
userFlagId | String | 用户唯一标识 |
chainName | String | 主链名称 |
amount | float64 | 本币金额 |
tokenList | Array | 代币余额列表 |
子字段:tokenList
参数名 | 类型 | 描述 |
---|---|---|
tokenName | String | 代币名称 |
tokenAmount | float64 | 该代币余额 |