强制平仓

强制平仓保护系统免受无法再履行保证金义务的账户影响。当账户权益跌破其维持保证金要求时，Hypercall 首先会尝试通过平掉空头期权来修复账户。如果未能及时修复，账户将升级为完全清算。

触发条件

当账户变为**资不抵债（underwater）**时触发强制平仓：

组合保证金：

\text{权益} < \text{所需维持保证金}

标准保证金：

\text{现金} < \text{所需 MM}

SM 清算由现金维持余量（cash - mm_required）驱动，而非权益，因此提高 NAV 的多头期权标记价格并不能防止现金缺口。API 字段 maintenance_margin = equity - mm_required 仍会返回，但它不是 SM 的清算触发条件。参见标准保证金。

对于组合保证金账户，权益已扣除欠 PM 借贷池的任何款项，维持保证金要求也考虑了 Hyperliquid 自身对您在 HyperCore 上永续合约的强制平仓。Hyperliquid 仍可能按其自身规则独立于 Hypercall 对这些永续合约进行强制平仓。参见组合保证金。

Hypercall 每 5 秒检查一次所有持仓账户的健康状况。

状态

状态	正在发生什么	订单
Healthy	PM：权益不低于所需 MM。SM：现金不低于所需 MM。	允许所有订单
PreLiquidation	部分清算：Hypercall 针对账户的空头期权下达平仓订单	仅允许减少现有持仓的订单
InLiquidation	完全清算。标准保证金：账户的持仓簿被提供给清算人	仅允许减少现有持仓的订单
Liquidated	清算人已接管账户的持仓簿	仅允许减少现有持仓的订单

在 PreLiquidation 和 InLiquidation 状态下，提现和 PM 现金归集均被禁用。一旦 PM 账户进入完全清算的处置流程，其所有订单都将被阻止。

状态转换

Healthy 到 PreLiquidation：账户跌破其 MM 阈值。
PreLiquidation 到 Healthy：账户达到带缓冲的目标，即所需 MM × 1.05，且其清算订单均已不再挂单。该边界为包含关系。
PreLiquidation 到 InLiquidation：账户仍低于目标，且满足下述任一升级条件。
InLiquidation 到 Healthy：账户在清算人接管之前恢复，完全清算被终止。
InLiquidation 到 Liquidated：清算人接管账户。

部分清算

当账户进入 PreLiquidation 时：

会增加风险的订单将被立即拒绝。减少现有持仓的订单仍会被接受。
Hypercall 取消您会增加风险的挂单，并针对您的空头期权下达只减仓买单，规模以使账户恢复至所需 MM × 1.05 为准。系统优先平掉每张合约释放保证金最多的空头。
每笔订单的价格为最优卖价（若无卖价，则为中间价或买价）加上清算奖励。奖励从 0.5% 开始，在 5 分钟内线性上升至 10%。订单每 5 秒重新定价一次。
一旦账户恢复至目标或以上且清算订单已全部消失，账户即返回 Healthy。

该奖励是您的成本：它是您为快速平掉空头而支付的高于市场价的部分。

请利用这段时间自行修复账户：

存入抵押品
平仓，尤其是空头期权
取消会增加风险的订单

升级为完全清算

处于 PreLiquidation 且仍低于目标的账户，在满足以下任一条件时将升级为完全清算：

权益为负。
已无空头期权可供部分清算平仓。
超过升级截止时间。 截止时间为账户进入 PreLiquidation 后的 20 分钟。

20 分钟的窗口也意味着短暂的异常标记价格不会将账户直接推入完全清算。

完全清算

对于标准保证金账户，完全清算会将账户的持仓簿移交给 Hypercall 引擎内的清算人。Hypercall 首先取消该账户的所有挂单，然后再提供该账户。

清算人必须使账户恢复至所需 MM × 1.05，因此由其补足账户缺少的保证金。
如果账户仍有正权益，清算人会将该权益支付给您。
清算人接收所有持仓及账户现金。

如果账户在清算人接管之前恢复，完全清算将被终止，账户返回 Healthy。

对于组合保证金账户，上述部分清算是您需要重点规划的环节。PM 账户一旦升级，其挂单将被取消，且在处置期间其订单将被阻止；该步骤的其余部分确定后，本页将补充说明。

超出权益的损失

超出账户权益的损失绝不会通过平掉其他交易者的仓位来弥补；Hypercall 没有自动减仓机制。由谁承担取决于保证金模式。

标准保证金。 清算人按原样接收账户的持仓和现金，包括亏空。负权益造成的缺口由清算人承担。

组合保证金。 清算后账户仍欠的款项（借贷池贷款和未付结算）按固定顺序处理：

借款人的抵押品。 Hypercall 从账户的 HyperCore 抵押品中收回。参见追偿。只有在追偿手段用尽后，贷款才会被核销。
首损准备金。 先按批次从旧到新，向借款人仍欠结算款的账户付款，再弥补被核销的贷款。
池内出借人。 准备金无法弥补的部分会压低池份额价格。

债务不会被免除。之后从借款人处追回的资金，先按批次从旧到新支付仍被拖欠的结算对手方，再偿还尚未结清的资金池贷款；只有剩余部分才按各自损失比例归还储备金和出借人。首损储备金只为 PM 贷款提供保障，平台没有全局保险基金。

API 端点

获取清算状态

GET /liquidation/status?wallet=0x...

对于从未离开 Healthy 状态的账户，data 为 null。

响应：

{
  "success": true,
  "data": {
    "wallet": "0x...",
    "state": "pre_liquidation",
    "liquidation_mode": "partial",
    "margin_mode": "portfolio",
    "equity": "4500.00",
    "mm_required": "5000.00",
    "maintenance_margin": "-500.00",
    "shortfall": "500.00",
    "partial_liquidation": {
      "entered_at": 1737312000000,
      "target_equity": "5250.00",
      "mm_shortfall": "500.00",
      "escalation_deadline": 1737313200000,
      "bonus_bps": 50
    },
    "full_liquidation": null
  }
}

partial_liquidation 还会列出未完成的清算订单 ID。full_liquidation 包含接管详情，包括 margin_needed、winner 以及当前所需出价。

获取清算历史

GET /liquidation/history?wallet=0x...&limit=20

返回账户的状态转换历史。

获取公开清算历史

GET /liquidations?limit=50

按时间倒序返回所有钱包的清算状态转换历史。该端点为公开端点，采用游标分页，供清算机器人和监控工具使用。

查询参数

cursor：上一页返回的不透明游标。
limit：每页条数，默认 50，最大 100。
wallet：可选的钱包筛选。
status 或 state：可选的清算转换状态筛选。可接受的值为 healthy、pre_liquidation、in_liquidation 和 liquidated。
margin_mode：可选的保证金模式筛选。可接受的值为 standard 和 portfolio。
liquidation_mode：可选的清算模式筛选。可接受的值为 partial 和 full。

响应：PublicLiquidationsResponse，包含清算转换条目以及用于下一次请求的 page.next_cursor。

获取拍卖详情

GET /liquidation/auction/{auction_id}

返回完全清算的状态、持仓和结算详情。

WebSocket 通知

清算状态变化会在 liquidation 频道上广播：

{
  "type": "LiquidationStateChange",
  "wallet_address": "0x...",
  "previous_state": "healthy",
  "new_state": "pre_liquidation",
  "liquidation_mode": "partial",
  "margin_mode": "portfolio",
  "equity": "4500.00",
  "mm_required": "5000.00",
  "maintenance_margin": "-500.00",
  "shortfall": "500.00",
  "partial_liquidation": { "escalation_deadline": 1737313200000, "bonus_bps": 50 },
  "full_liquidation": null,
  "timestamp": 1737312000000
}

partial_liquidation 和 full_liquidation 包含与状态端点相同的字段。订阅即可接收您钱包的实时更新。

参数

参数	值	说明
健康检查间隔	5 秒	检查账户健康状况的频率
恢复目标	所需 MM × 1.05	返回 Healthy 所需的权益（PM）或现金（SM），也是完全清算恢复到的水平
最低缺口	0	任何缺口都会启动部分清算
清算奖励	0.5%，在 5 分钟内升至 10%	部分清算订单相对参考价格的溢价
重新定价间隔	5 秒	部分清算订单重新定价的频率
升级截止时间	20 分钟	在 PreLiquidation 状态停留多久后开始完全清算

最佳实践

交易者须知

监控保证金比率：保持权益远高于 MM（建议保留 2 倍缓冲）
设置提醒：使用 WebSocket 及早发现预清算
备足资金：准备好可随时存入的备用抵押品
自行平掉空头：您自己下达的订单无需支付清算奖励

查询健康状况

请定期检查您的保证金状态：

curl "https://api.hypercall.xyz/portfolio?wallet=0x..."

# Look for:
# - span_margin.equity vs span_margin.maintenance_margin_required (portfolio)
# - margin_summary.standard_margin.maintenance_margin_headroom (standard)

另请参阅：

组合保证金：组合账户的 MM 计算
标准保证金：标准账户的 MM 计算
保证金下限：影响清算阈值的安全下限
PM 融资：PM 债务的收回方式
PM 风险参数：MM 比率及其他所有现行 PM 设置
模拟 PM 风险：检查假设持仓的 MM 余量

触发条件​

状态​

状态转换​

部分清算​

升级为完全清算​

完全清算​

超出权益的损失​

API 端点​

获取清算状态​

获取清算历史​

获取公开清算历史​

获取拍卖详情​

WebSocket 通知​

参数​

最佳实践​

交易者须知​

查询健康状况​