3、Query Wallet Address Balance

Request Method

• POST

Request URL

/api/v3/wallet/query/address

Request Header

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

Request Header Parameters

Parameter Name	Type	Description	Example Value
access_key	String	Merchant backend obtained key	pFqV75X3
timestamp	int64	13-digit timestamp (milliseconds)	1679724896223
nonce	String	Random string (UUID V4)	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	Signature generated using the key	kAXyh+eerqrefyaF8dyFB0M4FVo=

Request Parameters (JSON)

{
  "address": "TYpFF2AjK82tcXEiJCwR2FPWsPPyaSiGQB"
}

Parameter Descriptions

Parameter Name	Type	Description	Required
address	String	Wallet address (TRON/ETH, etc.)	✅ Yes

Response Type

Header: {
  "Content-Type": "application/json;charset=utf-8"
}

Response Example

{
  "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
      }
    ]
  }
}

Response Parameter Descriptions

Parameter Name	Type	Description
walletAddress	String	Wallet address
merchant	String	Merchant information
userFlagId	String	Unique user identifier
chainName	String	Main chain name
amount	float64	Native currency amount
tokenList	Array	Token balance list

Subfields of tokenList

Parameter Name	Type	Description
tokenName	String	Token name
tokenAmount	float64	Token balance