按币种查询待结算余额

按币种查询待结算余额

GET /api/v1/pending_settlement_balance

cURL

curl --request GET \
  --url "https://api.stablepay.co/api/v1/pending_settlement_balance" \
  --header "Authorization: Bearer <API_KEY>" \
  --header "X-StablePay-Timestamp: <TIMESTAMP>" \
  --header "X-StablePay-Nonce: <NONCE>" \
  --header "X-StablePay-Signature: <SIGNATURE>"

200

{
  "balances": [
    {
      "currency": "USDT",
      "amount": 2500
    },
    {
      "currency": "USDC",
      "amount": -100
    }
  ],
  "as_of": 1789084800
}

完整认证、签名、数据约定与错误响应。每次重试均须重新生成时间戳、nonce 与签名。

GET /pending_settlement_balance 按币种返回商户维度的待结算账面余额，允许负值。

请求头

Authorization · string · 必填

Bearer API Key。

X-StablePay-Timestamp · string · 必填

Unix 秒，允许与服务端相差最多 5 分钟。

X-StablePay-Nonce · string · 必填

每次请求唯一的随机串，16–64 字符。

X-StablePay-Signature · string · 必填

HMAC-SHA256 签名，小写十六进制；签名必须对应实际发送的请求体。

请求参数

merchant_id · string

10 位数字；商户 App 不传，服务商 App 传值指定作用商户

响应

balances · array · 必填

按币种汇总

balances[].currency · string · 必填

币种代码

balances[].amount · integer · 必填

账面余额，允许负值

as_of · integer · 必填

观察时间

状态与错误

503 服务暂时不可用，换新 nonce 重试。

cURL

curl --request GET \
  --url "https://api.stablepay.co/api/v1/pending_settlement_balance" \
  --header "Authorization: Bearer <API_KEY>" \
  --header "X-StablePay-Timestamp: <TIMESTAMP>" \
  --header "X-StablePay-Nonce: <NONCE>" \
  --header "X-StablePay-Signature: <SIGNATURE>"

200

{
  "balances": [
    {
      "currency": "USDT",
      "amount": 2500
    },
    {
      "currency": "USDC",
      "amount": -100
    }
  ],
  "as_of": 1789084800
}