{
"balances": [
{
"currency": "USDT",
"amount": 2500
},
{
"currency": "USDC",
"amount": -100
}
],
"as_of": 1789084800
}{
"error": {
"code": "internal_error",
"message": "服务内部错误。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "service_unavailable",
"message": "余额查询服务暂时不可用,请稍后使用新的时间戳、nonce 和签名重试。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}全球账户 API
查询待结算余额
查询当前 API Key 所属商户按币种汇总的待结算账面余额。无需 merchant_id;响应仅包含 balances 和 as_of,不返回 merchant_id。
币种金额字段为 amount。这是商户维度的独立汇总,不关联 account_no,不能加到每个账户的 total_amount 上。当前版本按内部待结算账户总余额汇总,包含其中的冻结部分;不能解释为“已扣除冻结或预留的可用待结算金额”。
认证方式沿用公共认证规范。无需传入 merchant_id 或 X-Merchant-Id,服务端只查询当前 API Key 所属商户的数据。无请求体。金额示例为虚构数据,使用账本最小单位。
GET
/
api
/
v1
/
pending_settlement_balance
{
"balances": [
{
"currency": "USDT",
"amount": 2500
},
{
"currency": "USDC",
"amount": -100
}
],
"as_of": 1789084800
}{
"error": {
"code": "internal_error",
"message": "服务内部错误。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "service_unavailable",
"message": "余额查询服务暂时不可用,请稍后使用新的时间戳、nonce 和签名重试。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}授权
Bearer API Key,例如 Bearer sk_live_xxx。
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符。
使用商户 API Secret 计算的 HMAC-SHA256 小写 hex 签名。
请求头
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
Required string length:
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
最后修改于 2026年10月13日
此页面对您有帮助吗?
