# 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": "123123@qq.com",
"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 | 該代幣餘額 |