4、Query Balance

API Description

This endpoint is used to query the balance information of all cryptocurrencies and blockchains under the merchant's wallet, including available balance, frozen amount, and pending transfer amount.

Request Method

GET

Request URL

/api/v3/wallet/query/balance

Request Header

Content-Type: application/json;charset=utf-8

Parameter Name	Description	Example Value
access_key	Obtained from the merchant backend	pFqV75X3
timestamp	Unix timestamp (13 digits)	1679724896223
nonce	UUID V4	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	HMAC-SHA1 signature	kAXyh+eerqrefyaF8dyFB0M4FVo=

Response Data Example

{
  "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"
    }
     // ... Other cryptocurrency and blockchain combinations
  ]
}

Response Field Description

Field Name	Type	Description
accountStatusId	int64	Account status ID (e.g., 4 means normal deposit and withdrawal)
accountBalance	String	Available balance
accountFreezeAmount	String	Frozen balance (temporarily unavailable)
accountWaitSettledAmount	String	Pending transfer amount (transaction successful, awaiting settlement)
chainType	String	Blockchain type, such as ETH / TRON / BSC
tokenType	String	Cryptocurrency type, such as USDT / USDC / BUSD
accountStatus	String	Account status description, such as: InAndOut

📌 Notes

• A merchant account may have multiple chainType + tokenType combinations.
• All amount fields are of string type, with precision depending on the token's precision.
• The returned list is not fixed and only includes cryptocurrencies and chains that are active or have a balance in the merchant's account.
• If you need to perform transfer, withdrawal, or other operations for a specific chain, ensure that the corresponding chain has available balance.