查询钱包余额
查询指定币种的钱包余额与累计收支信息,账户尚无钱包记录时返回零余额对象,不会因查询创建钱包记录。/papi/wallet/get 为同一接口的兼容路径。
接口地址:
text
/papi/wallet/balance请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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,默认 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": ""
}