跳到主要内容

统一账户快照

返回调用者的 unified-margin 账户实时计算快照：权益、初始 / 维持保证金、uniMMR、账户状态。

响应数值与后台风控 Worker 用于状态转换的值一致；每次请求都重新从（钱包余额 + 开仓 + 最新 mark price）重算。

HTTP 请求​

GET /api/v1/unified/account (HMAC SHA256)

请求参数​

名称类型是否必需描述
timestampLONGYES时间戳

响应示例​

{
    "margin_mode": "unified",
    "wallet_balance": "12345.678901234567890000",
    "total_equity": "12450.123456789012345678",
    "available_balance": "10450.123456789012345678",
    "total_initial_margin": "2000.000000000000000000",
    "total_maintenance_margin": "120.500000000000000000",
    "total_unrealized_pnl": "104.444555554444555554",
    "uni_mmr": "103.320525782584122371",
    "account_status": "normal"
}

字段说明​

字段含义
margin_mode当前账户模式（isolated 或 unified）
wallet_balance抵押币的 available + frozen
total_equitywallet_balance + Σ 未实现盈亏 − Σ 累计费用
available_balancetotal_equity − total_initial_margin，新开仓预算
total_initial_marginΣ (名义价值 / 杠杆)
total_maintenance_margin梯度 MMR 下的 Σ 各仓位 MM
total_unrealized_pnl各仓位按当前 mark 计算的未实现盈亏总和
uni_mmrtotal_equity / total_maintenance_margin；无仓位时为 null
account_statusnormal / warning_1 / warning_2 / reduce_only / liquidating 之一

逐仓模式下的行为​

margin_mode == "isolated" 时调用该接口同样返回有效快照：数字代表账户若切到 unified 会是什么样。适合前端在用户切换前预览效果。

代码示例​

curl​

API_KEY="your_api_key"
API_SECRET="your_api_secret"
TIMESTAMP=$(date +%s%3N)
QUERY="timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "${QUERY}" | openssl dgst -sha256 -hmac "${API_SECRET}" | awk '{print $2}')
curl -s -H "X-MBX-APIKEY: ${API_KEY}" \
  "https://api.ztdx.io/api/v1/unified/account?${QUERY}&signature=${SIGNATURE}"

Python​

import time, hmac, hashlib, requests

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"

ts = int(time.time() * 1000)
q = f"timestamp={ts}"
sig = hmac.new(API_SECRET.encode(), q.encode(), hashlib.sha256).hexdigest()
r = requests.get(
    f"https://api.ztdx.io/api/v1/unified/account?{q}&signature={sig}",
    headers={"X-MBX-APIKEY": API_KEY},
)
snap = r.json()
print(f"uniMMR={snap['uni_mmr']} status={snap['account_status']}")