4、查询余额

接口说明

用于查询当前商户钱包下所有币种、所有主链的余额信息，包括：可用余额、冻结金额、待划转金额等。

请求方式

GET

请求 URL

/api/v3/wallet/query/balance

请求 Header

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

参数名	描述	示例值
access_key	商户后台获取	pFqV75X3
timestamp	Unix时间戳13位	1679724896223
nonce	UUID V4	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	HMAC-SHA1签名	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 组合；
• 所有金额字段均为字符串类型，精度根据代币精度；
• 返回列表不固定，仅返回当前商户已激活或有余额的币种和链；
• 若需对某一链进行转账、出金等操作，请确保对应链下有可用余额。