Skip to main content

清算与保险基金 (Liquidation & Insurance Fund)

强平机制 (Liquidation)​

当用户的仓位保证金率低于 维持保证金率 (Maintenance Margin Rate) 时，将触发强制平仓。

清算触发条件​

当满足以下条件时触发清算：

保证金率 = (抵押品价值 + 未实现盈亏) / 仓位价值 < 维持保证金率

维持保证金率通常为 0.5%（根据市场配置可能不同）

清算流程​

  1. 清算触发: 系统检测到仓位保证金率低于维持保证金率
  2. 系统接管: 清算引擎接管仓位
  3. 市场平仓: 在市场上以最优价格平仓
  4. 清算费: 收取清算费用，存入保险基金
  5. 剩余返还: 如有剩余保证金，返还给用户

清算费用​

  • 清算费率：0.5% 的仓位价值
  • 清算费用从剩余保证金中扣除
  • 清算费用注入保险基金

获取清算配置​

接口信息​

  • Method: GET
  • Path: /api/v1/liquidations/:symbol/config
  • Authentication: 不需要

路径参数​

参数类型必须描述
symbolstring是交易对名称（如 BTCUSDT）

响应示例​

{
  "symbol": "BTCUSDT",
  "maintenance_margin_rate": "0.005",
  "liquidation_fee_rate": "0.005",
  "max_leverage": 100,
  "updated_at": "2024-01-01T00:00:00Z"
}

响应字段说明​

字段类型描述
symbolstring交易对
maintenance_margin_ratestring维持保证金率（0.005 = 0.5%）
liquidation_fee_ratestring清算费率（0.005 = 0.5%）
max_leveragenumber最大杠杆倍数
updated_atstring更新时间

获取市场清算记录​

接口信息​

  • Method: GET
  • Path: /api/v1/liquidations/:symbol
  • Authentication: 不需要

路径参数​

参数类型必须描述
symbolstring是交易对名称（如 BTCUSDT）

查询参数​

参数类型必须描述
limitnumber否返回数量（默认 50）

响应示例​

{
  "liquidations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "symbol": "BTCUSDT",
      "user_address": "0x742d35cc6634c0532925a3b844bc9e7595f0beb",
      "side": "long",
      "size": "6500.00",
      "liquidation_price": "60000.00",
      "mark_price": "59950.00",
      "collateral": "650.00",
      "liquidation_fee": "32.50",
      "insurance_fund_contribution": "617.50",
      "liquidated_at": "2024-01-01T00:00:00Z"
    }
  ]
}

响应字段说明​

字段类型描述
liquidationsarray清算记录列表

LiquidationRecord 对象字段​

字段类型描述
idstring清算记录 ID
symbolstring交易对
user_addressstring用户地址（部分隐藏）
sidestring仓位方向（long/short）
sizestring仓位大小（USD）
liquidation_pricestring清算价格
mark_pricestring标记价格
collateralstring抵押品数量
liquidation_feestring清算费用
insurance_fund_contributionstring注入保险基金金额
liquidated_atstring清算时间

获取用户清算历史​

接口信息​

  • Method: GET
  • Path: /api/v1/liquidations/history
  • Authentication: 需要身份验证

查询参数​

参数类型必须描述
limitnumber否返回数量（默认 50）

响应示例​

{
  "liquidations": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "symbol": "BTCUSDT",
      "position_id": "550e8400-e29b-41d4-a716-446655440001",
      "side": "long",
      "size": "6500.00",
      "entry_price": "65000.00",
      "liquidation_price": "60000.00",
      "mark_price": "59950.00",
      "collateral": "650.00",
      "liquidation_fee": "32.50",
      "remaining_collateral": "0.00",
      "liquidated_at": "2024-01-01T00:00:00Z"
    }
  ]
}

保险基金 (Insurance Fund)​

保险基金用于弥补清算单无法在破产价成交时产生的损失，从而防止分摊或 ADL。

保险基金来源​

  • 清算费: 每次清算收取的费用
  • 剩余保证金: 清算后的剩余抵押品
  • 系统注资: 平台定期注入资金

保险基金用途​

  • 弥补穿仓损失: 当清算价格劣于破产价格时
  • 维护系统稳定: 避免触发 ADL 机制
  • 保护用户利益: 确保盈利用户的利益

获取保险基金余额​

接口信息​

  • Method: GET
  • Path: /api/v1/insurance-fund/:symbol
  • Authentication: 不需要

路径参数​

参数类型必须描述
symbolstring是交易对名称（如 BTCUSDT）

响应示例​

{
  "symbol": "BTCUSDT",
  "balance": "150000.00",
  "total_contributions": "200000.00",
  "total_withdrawals": "50000.00",
  "last_updated": "2024-01-01T00:00:00Z"
}

响应字段说明​

字段类型描述
symbolstring交易对
balancestring当前余额（USD）
total_contributionsstring累计注入金额
total_withdrawalsstring累计支出金额
last_updatedstring最后更新时间

与 ADL 的关系​

清算和 ADL 是两个独立但相关的风险管理机制：

  1. 优先使用保险基金: 清算损失首先由保险基金承担
  2. 保险基金不足时: 才会触发 自动减仓 (ADL) 机制
  3. ADL 作为最后手段: 保护系统不出现负资产

触发顺序​

用户仓位爆仓 → 清算引擎平仓 → 保险基金弥补损失 → (如不足) 触发 ADL

如何避免清算​

  1. 合理使用杠杆: 避免过高杠杆
  2. 及时补充保证金: 监控保证金率，及时追加
  3. 设置止损: 使用止损单控制风险
  4. 分散仓位: 不要将所有资金集中在一个仓位
  5. 关注市场: 密切关注市场波动和资金费率

说明​

  • 清算是自动执行的，无需人工干预
  • 清算价格在开仓时就已确定
  • 可以通过增加保证金来降低清算价格
  • 清算记录公开透明，任何人都可以查询
  • 保险基金余额实时更新

相关接口​