获取钱包余额

GET/api/v1/wallets/{walletBizId}/balanceHMAC

返回指定钱包的当前余额信息。

请求头

Name	Type	Required	Description
X-Api-Key	string	Yes	API 密钥标识符
X-Signature	string	Yes	HMAC-SHA256 签名
X-Timestamp	string	Yes	Unix 时间戳（秒）
X-Nonce	string	Yes	唯一请求标识符（UUID）

路径参数

Name	Type	Required	Description
walletBizId	string	Yes	钱包业务 ID

请求示例

curl -X GET https://api.slaunchx.cc/api/v1/wallets/<walletBizId>/balance \
  -H "X-Api-Key: sk_live_xxx" \
  -H "X-Signature: <computed_signature>" \
  -H "X-Timestamp: 1709337600" \
  -H "X-Nonce: 550e8400-e29b-41d4-a716-446655440000"

const response = await fetch(
  'https://api.slaunchx.cc/api/v1/wallets/<walletBizId>/balance',
  {
    method: 'GET',
    headers: {
      'X-Api-Key': 'sk_live_xxx',
      'X-Signature': '<computed_signature>',
      'X-Timestamp': '1709337600',
      'X-Nonce': '550e8400-e29b-41d4-a716-446655440000',
    },
  }
);
const data = await response.json();

import requests

response = requests.get(
    'https://api.slaunchx.cc/api/v1/wallets/<walletBizId>/balance',
    headers={
        'X-Api-Key': 'sk_live_xxx',
        'X-Signature': '<computed_signature>',
        'X-Timestamp': '1709337600',
        'X-Nonce': '550e8400-e29b-41d4-a716-446655440000',
    },
)
data = response.json()

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.slaunchx.cc/api/v1/wallets/<walletBizId>/balance"))
    .header("X-Api-Key", "sk_live_xxx")
    .header("X-Signature", "<computed_signature>")
    .header("X-Timestamp", "1709337600")
    .header("X-Nonce", "550e8400-e29b-41d4-a716-446655440000")
    .GET()
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

响应

成功200

{
  "version": "1.3.0",
  "success": true,
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "walletBizId": "wlt_abc123",
    "currency": "USD",
    "availableBalance": 1300.25,
    "frozenBalance": 200,
    "totalBalance": 1500.25,
    "updatedAt": "2026-03-02T10:20:30Z"
  }
}