查询余额

查询指定币种的钱包余额及累计充值、扣款统计。/papi/wallet/balance 与 /papi/wallet/get 为同一接口的两个路径，请求体相同。

接口地址：

text

/papi/wallet/balance

请求方式：

text

POST

请求数据类型：

text

application/json

Header 参数：

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

Body 参数：

参数	类型	必填	说明
currency	string	否	币种代码，仅支持 USD

请求示例：

json

{
  "currency": "USD"
}

响应参数：

参数	类型	说明
code	integer	错误码，参见错误码说明
data	object	返回数据
├─ currency	string	币种代码
├─ currencySymbol	string	货币符号，如 USD 的 `$`
├─ balance	string	当前钱包余额，单位为美分
├─ totalRechargeAmount	string	累计充值金额，单位为美分
├─ totalDebitAmount	string	累计扣款金额，单位为美分
├─ status	string	钱包状态，如 `NORMAL`
├─ version	string	钱包版本号
msg	string	错误提示

响应示例：

json

{
  "code": 0,
  "data": {
    "currency": "USD",
    "currencySymbol": "$",
    "balance": "1250",
    "totalRechargeAmount": "2000",
    "totalDebitAmount": "750",
    "status": "NORMAL",
    "version": "3"
  },
  "msg": ""
}

说明：

余额、累计金额和版本号均为字符串，请勿通过浮点数处理。
账户尚无钱包记录时返回零余额对象，不会因查询而创建钱包记录。

查询余额 ​

查询余额