4、查詢餘額

• 請求方式

GET

• 請求 URL

/api/v3/wallet/query/balance

• 請求 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=

響應數據範例

{
  "code": "200",
  "success": true,
  "msg": "成功",
  "msgEn": "SUCCESS",
  "data": [
    {
      "accountStatusId": 4,
      "accountBalance": "346.525",
      "accountFreezeAmount": "0",
      "accountWaitSettledAmount": "0",
      "chainType": "ETH",
      "tokenType": "USDT",
      "accountStatus": "InAndOut"
    },
    {
      "accountStatusId": 4,
      "accountBalance": "479.938888",
      "accountFreezeAmount": "0",
      "accountWaitSettledAmount": "0",
      "chainType": "TRON",
      "tokenType": "USDT",
      "accountStatus": "InAndOut"
    }
    // ... 其他币种和主链组合
  ]
}

響應欄位說明

欄位名	類型	描述
accountStatusId	int64	賬戶狀態編號（如：4 表示可正常出入金）
accountBalance	String	可用餘額
accountFreezeAmount	String	凍結餘額（暫不可用）
accountWaitSettledAmount	String	待劃轉金額（交易成功，待結算）
chainType	String	主鏈類型，如 ETH / TRON / BSC
tokenType	String	加密幣種，如 USDT / USDC / BUSD 等
accountStatus	String	賬戶狀態文字描述，如：InAndOut

📌 注意事項

• 一個商戶賬戶下，可能有多個 chainType + tokenType 組合；
• 所有金額欄位均為字串類型，精度根據代幣精度；
• 返回列表不固定，僅返回當前商戶已激活或有餘額的幣種和鏈；
• 若需對某一鏈進行轉賬、出金等操作，請確保對應鏈下有可用餘額。