商户余额查询

通过本接口可实时查询当前商户在 SureLink 网关中的数字资产（USDT）账本余额，包括可用于代付或提币的可用余额、正在处理中的冻结资金以及账户总资产。

---

1. 查询商户余额

GET /api/v1/balance

请求头 (Headers)

需携带标准 HMAC 鉴权请求头（X-Api-Key、X-Timestamp、X-Nonce、X-Signature）。

由于是 GET 请求，待签名源串为： $$\text{Signing String} = \text{X-Timestamp} + \text{"."} + \text{X-Nonce} + \text{"."}$$

请求参数

无（商户身份完全由请求头中的 API Key 与签名解析确定）。

---

请求示例

cURL

curl -X GET "https://api-sandbox.surelink.io/api/v1/balance" \
  -H "X-Api-Key: mch_key_your_api_key" \
  -H "X-Timestamp: 1715000000000" \
  -H "X-Nonce: 9f8e7d6c5b4a392817263544a1b2c3d4" \
  -H "X-Signature: c8b9...f01"

Node.js

import { sendSignedRequest } from './signer';

const balance = await sendSignedRequest({
  apiKey: 'mch_key_...',
  apiSecret: 'sec_...',
  method: 'GET',
  url: 'https://api-sandbox.surelink.io/api/v1/balance'
});

console.log('可用余额:', balance.available);
console.log('冻结金额:', balance.frozen);
console.log('账户总额:', balance.total);

Python 3

from signer import make_signed_request

balance = make_signed_request(
    api_key="mch_key_...",
    api_secret="sec_...",
    method="GET",
    url="https://api-sandbox.surelink.io/api/v1/balance"
)

print(f"可用: {balance['available']}, 冻结: {balance['frozen']}, 总计: {balance['total']}")

---

响应说明 (Response)

• HTTP 状态码：200 OK

{
  "merchantId": "3b2e5a7d-8f90-4c12-9e34-5a6b7c8d9e0f",
  "currency": "USDT",
  "available": "8500.500000",
  "frozen": "1200.000000",
  "total": "9700.500000"
}

返回字段描述

字段	类型	说明
merchantId	string	当前认证商户的唯一 ID
currency	string	结算资产符号，固定为 'USDT'
available	string	可用余额（保留 6 位小数），可自由用于发起代付出金或链上提币
frozen	string	冻结金额（保留 6 位小数），正在进行中的代付订单或争议挂起资金
total	string	账户总额（保留 6 位小数），即 available + frozen