现货余额

描述

返回当前已认证用户在现货钱包中持有的所有 (token, available, frozen) 记录。包含该钱包曾经入账的每种代币——无论是基础代币 (DF) 还是报价代币 (USDT)——即使余额为零也会返回。

HTTP 请求

GET /spot/balances（JWT 或 API Key）

权重

0 — 当前 MVP 阶段不设每 IP 频率限制。

响应示例

200 OK

{
  "balances": [
    { "token": "DF",   "available": "1234.5",  "frozen": "0"   },
    { "token": "USDT", "available": "5000",    "frozen": "100" }
  ]
}

字段	说明
balances	每个用户曾持有的代币对应一条记录，可能为空数组。
balances[].token	代币符号，当前为 DF 或 USDT。
balances[].available	可提现 / 可划转的余额 (available)。十进制字符串，不使用科学计数法，末尾零已去除（例如 1234.50000000000000 → 1234.5）。
balances[].frozen	为进行中的提现所预留的冻结 (frozen) 金额。十进制字符串。

错误响应

HTTP	error
401	（空响应体） — 凭证缺失或无效。
500	internal error — 意外的数据库错误。

完整列表：错误码。

代码示例

cURL（JWT）

JWT="your_jwt_token"

curl -s "https://api-sepolia.p99.world/api/v1/spot/balances" \
  -H "Authorization: Bearer ${JWT}"

cURL（HMAC API Key）

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
PAYLOAD="timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${PAYLOAD}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')

curl -s \
  -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api-sepolia.p99.world/api/v1/spot/balances?timestamp=${TIMESTAMP}&signature=${SIGNATURE}"

Python

import time, hmac, hashlib, requests

API_KEY    = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL   = "https://api-sepolia.p99.world/api/v1"

def signed_get(path: str) -> dict:
    ts = int(time.time() * 1000)
    payload = f"timestamp={ts}"
    sig = hmac.new(API_SECRET.encode(), payload.encode(), hashlib.sha256).hexdigest()
    r = requests.get(
        f"{BASE_URL}{path}?timestamp={ts}&signature={sig}",
        headers={"X-MBX-APIKEY": API_KEY},
        timeout=5,
    )
    r.raise_for_status()
    return r.json()

data = signed_get("/spot/balances")
for b in data["balances"]:
    print(f"  {b['token']:5}  available={b['available']:>14}  frozen={b['frozen']}")