Skip to content

查询钱包余额 ​

查询指定币种的钱包余额与累计收支信息,账户尚无钱包记录时返回零余额对象,不会因查询创建钱包记录。/papi/wallet/get 为同一接口的兼容路径。

接口地址:

text
/papi/wallet/balance

请求方式:

text
POST

请求数据类型:

text
application/json

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

参数类型必填说明
currencystring否币种代码,仅支持 USD,默认 USD

请求示例:

json
{
  "currency": "USD"
}

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ currencystring币种代码
├─ currencySymbolstring货币符号,如 USD 的 $
├─ balancestring当前钱包余额(美分)
├─ totalRechargeAmountstring累计充值金额(美分)
├─ totalDebitAmountstring累计扣款金额(美分)
├─ statusstring钱包状态(NORMAL-正常)
├─ versionstring钱包版本号
msgstring错误提示

响应示例:

json
{
  "code": 0,
  "data": {
    "currency": "USD",
    "currencySymbol": "$",
    "balance": "1250",
    "totalRechargeAmount": "2000",
    "totalDebitAmount": "750",
    "status": "NORMAL",
    "version": "3"
  },
  "msg": ""
}
Copyright © 2026 HongKong Quantity Best Technology Limited

QTPhone 帮助中心