统一保证金概述
统一保证金（Portfolio Margin）是一种可选的账户模式，同一用户的所有开仓共享一个保证金池。 对冲头寸（如 BTC 多 + ETH 空）会互相抵消保证金需求，大幅提升资金利用率。
用户同一时刻只处于一种模式。模式切换需要显式调用且有硬性前置条件，见 切换保证金模式。
| 逐仓（默认） | 统一 | |
|---|---|---|
| 保证金归属 | 每个仓位独立 | 账户级共享池 |
| 风控指标 | 单仓位维持保证金率 | 账户级 uniMMR |
| 清算 | 逐个仓位独立 | 跨仓位瀑布式 |
| 适合场景 | 单边方向性交易 | 对冲 / 多腿策略 |
关键概念
uniMMR（统一维持保证金率）
描述统一账户健康度的单一指标：
uniMMR = 总权益 / 总维持保证金
总权益 = 钱包余额 + Σ 未实现盈亏 − Σ 累计费用（资金费 + 借贷费）
总维持保证金 = Σ 各仓位 MM
账户无开仓时 uniMMR 为 null，视为安全状态。
状态机
风控 Worker 每 2 秒重新计算每个 unified 账户，按以下阶梯进行状态转换：
| 区间 | 状态 | 副作用 |
|---|---|---|
uniMMR > 2.00 或无仓位 | normal | — |
uniMMR ≤ 2.00 | warning_1 | 风险预警 WS 推送 |
uniMMR ≤ 1.50 | warning_2 | 二次预警 |
uniMMR ≤ 1.20 | reduce_only | 自动撤销全部挂单；新开仓订单被拒 |
uniMMR ≤ 1.05 | liquidating | 触发强平引擎 — 每 tick 平一个亏损最大的仓位 |
uniMMR 回升到阈值之上时自动恢复（正在执行的 tick 内已触发的清算除外）。
梯度维持保证金
每个仓位的 MM 按 symbol 的分层表计算。每层包含 notional 上限、MMR 与累计扣减额， 跨层保持连续：
MM_仓位 = 名义价值 × MMR − 累计扣减额 (cum_amount)
默认梯度（当某 symbol 未配置专属梯度时生效）：
| 层 | 名义上限 (USD) | MMR | 最大杠杆 |
|---|---|---|---|
| 1 | 50,000 | 0.40% | 125× |
| 2 | 250,000 | 0.50% | 100× |
| 3 | 1,000,000 | 1.00% | 50× |
| 4 | 5,000,000 | 2.50% | 20× |
| 5 | 20,000,000 | 5.00% | 10× |
| 6 | 50,000,000 | 10.00% | 5× |
| 7 | 100,000,000 | 12.50% | 4× |
| 8 | 200,000,000 | 15.00% | 2× |
下单校验
unified 模式下用户下新开仓订单时，后端会模拟成交后的 uniMMR。满足以下任一条件订单被拒绝：
- 账户状态为
reduce_only或liquidating；或 available_balance − new_initial_margin < 0；或simulated_uniMMR < 1.10。
减仓 / 平仓订单不受此校验影响。
接口一览
| 方法 | 路径 | 用途 |
|---|---|---|
POST | /api/v1/account/margin-mode | 切换模式 |
GET | /api/v1/unified/account | 账户快照 |
POST | /api/v1/unified/risk/simulate | 下单预览 |
GET | /api/v1/unified/liquidations | 清算历史 |
WS | 频道 unified_account | 实时推送 |
所有接口托管在 https://api.ztdx.io，使用与 /api/v1/* 其他接口相同的
HMAC-SHA256 / JWT 鉴权。