注册商户

GET · /api/v1/wallet/balance/summary

余额汇总

按（链 × 代币）维度返回当前应用全部地址的余额快照合计。适用于看板总览与对账核查。

快照口径

本接口数据来自系统定期采集的余额快照，非实时链上数据。 如需查询某个地址的即时余额，请使用 查询指定地址余额。
GET/api/v1/wallet/balance/summary HMAC

Header 参数

X-Api-Key
string required
应用 apiKey。沙箱前缀 pk_test_，正式 pk_live_。
例： pk_test_4f9d8ab1c0e74...
X-Timestamp
integer (UNIX 毫秒) required
请求发起时刻的 UNIX 毫秒时间戳（13 位整数）。与服务端时差不能超过 ±300000ms（5 分钟）。
例： 1746450000000
X-Nonce
string required
本次请求的随机串，建议 UUID v4 或 16 字节 hex。同一 (apiKey, nonce) 在 10 分钟窗口内不可重复。
例： 8e3a1c2f7b6d4a90
X-Signature
string required
HMAC-SHA256 签名（小写 hex，64 字符）。算法：HMAC(secret, METHOD + "\n" + PATH + "\n" + ts + "\n" + nonce + "\n" + SHA256(body))。详见 鉴权章节。
例： 6e4a8c1f...（64 字符）

请求示例

# 签名算法（stringToSign / 4 个 header）见 /docs/api/auth
API_KEY=pk_live_xxx
SECRET=sk_live_xxx
METHOD=GET
REQ_PATH=/api/v1/wallet/balance/summary
TS=$(( $(date +%s) * 1000 ))
NONCE=$(uuidgen | tr -d '-' | tr '[:upper:]' '[:lower:]')
BODY_SHA=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
SIG=$(printf "%s\n%s\n%s\n%s\n%s" "$METHOD" "$REQ_PATH" "$TS" "$NONCE" "$BODY_SHA" \
  | openssl dgst -sha256 -hmac "$SECRET" -hex | awk '{print $2}')

curl "https://api.pqpa.com$REQ_PATH" \
  -H "X-Api-Key:    $API_KEY" \
  -H "X-Timestamp:  $TS" \
  -H "X-Nonce:      $NONCE" \
  -H "X-Signature:  $SIG"

响应

Response
200OK
{
  "code": 0,
  "data": [
    {
      "chainCode": "ETH",
      "chainName": "Ethereum",
      "chainTokenId": 19,
      "tokenSymbol": "USDT",
      "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "decimals": 6,
      "totalBalance": "125300.500000",
      "addressCount": 842
    },
    {
      "chainCode": "ETH",
      "chainName": "Ethereum",
      "chainTokenId": 1,
      "tokenSymbol": "ETH",
      "contractAddress": null,
      "decimals": 18,
      "totalBalance": "4.321000000000000000",
      "addressCount": 120
    }
  ],
  "msg": ""
}

data[] 字段说明

chainCode
string required
公链 code，如 ETH、TRX。
例： ETH
chainName
string required
公链名称。
例： Ethereum
chainTokenId
integer required
链上代币 id（见 支持的代币）。
例： 19
tokenSymbol
string required
代币符号。
例： USDT
contractAddress
string | null required
合约地址；原生币（ETH / TRX 等）为 null。
decimals
integer required
代币小数位。
例： 6
totalBalance
string required
应用内全部地址余额快照合计（字符串金额，保留 6 位小数）。
例： "125300.500000"
addressCount
integer required
有该 token 余额快照的地址数量。
例： 842

下一步