清算与保险基金 (Liquidation & Insurance Fund)
强平机制 (Liquidation)
当用户的仓位保证金率低于 维持保证金率 (Maintenance Margin Rate) 时，将触发强制平仓。
清算触发条件
当满足以下条件时触发清算：
保证金率 = (抵押品价值 + 未实现盈亏) / 仓位价值 < 维持保证金率
维持保证金率通常为 0.5%（根据市场配置可能不同）
清算流程
- 清算触发: 系统检测到仓位保证金率低于维持保证金率
- 系统接管: 清算引擎接管仓位
- 市场平仓: 在市场上以最优价格平仓
- 清算费: 收取清算费用，存入保险基金
- 剩余返还: 如有剩余保证金，返还给用户
清算费用
- 清算费率：0.5% 的仓位价值
- 清算费用从剩余保证金中扣除
- 清算费用注入保险基金
获取清算配置
接口信息
- Method:
GET - Path:
/api/v1/liquidations/:symbol/config - Authentication: 不需要
路径参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| symbol | string | 是 | 交易对名称（如 BTCUSDT） |
响应示例
{
"symbol": "BTCUSDT",
"maintenance_margin_rate": "0.005",
"liquidation_fee_rate": "0.005",
"max_leverage": 100,
"updated_at": "2024-01-01T00:00:00Z"
}
响应字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| symbol | string | 交易对 |
| maintenance_margin_rate | string | 维持保证金率（0.005 = 0.5%） |
| liquidation_fee_rate | string | 清算费率（0.005 = 0.5%） |
| max_leverage | number | 最大杠杆倍数 |
| updated_at | string | 更新时间 |
获取市场清算记录
接口信息
- Method:
GET - Path:
/api/v1/liquidations/:symbol - Authentication: 不需要
路径参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| symbol | string | 是 | 交易对名称（如 BTCUSDT） |
查询参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| limit | number | 否 | 返回数量（默认 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"
}
]
}
响应字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| liquidations | array | 清算记录列表 |
LiquidationRecord 对象字段
| 字段 | 类型 | 描述 |
|---|---|---|
| id | string | 清算记录 ID |
| symbol | string | 交易对 |
| user_address | string | 用户地址（部分隐藏） |
| side | string | 仓位方向（long/short） |
| size | string | 仓位大小（USD ） |
| liquidation_price | string | 清算价格 |
| mark_price | string | 标记价格 |
| collateral | string | 抵押品数量 |
| liquidation_fee | string | 清算费用 |
| insurance_fund_contribution | string | 注入保险基金金额 |
| liquidated_at | string | 清算时间 |
获取用户清算历史
接口信息
- Method:
GET - Path:
/api/v1/liquidations/history - Authentication: 需要身份验证
查询参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| limit | number | 否 | 返回数量（默认 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: 不需要
路径参数
| 参数 | 类型 | 必须 | 描述 |
|---|---|---|---|
| symbol | string | 是 | 交易对名称（如 BTCUSDT） |
响应示例
{
"symbol": "BTCUSDT",
"balance": "150000.00",
"total_contributions": "200000.00",
"total_withdrawals": "50000.00",
"last_updated": "2024-01-01T00:00:00Z"
}
响应字段说明
| 字段 | 类型 | 描述 |
|---|---|---|
| symbol | string | 交易对 |
| balance | string | 当前余额（USD） |
| total_contributions | string | 累计注入金额 |
| total_withdrawals | string | 累计支出金额 |
| last_updated | string | 最后更新时间 |
与 ADL 的关系
清算和 ADL 是两个独立但相关的风险管理机制：
- 优先使用保险基金: 清算损失首先由保险基金承担
- 保险基金不足时: 才会触发 自动减仓 (ADL) 机制
- ADL 作为最后手段: 保护系统不出现负资产
触发顺序
用户仓位爆仓 → 清算引擎平仓 → 保险基金弥补损失 → (如不足) 触发 ADL
如何避免清算
- 合理使用杠杆: 避免过高杠杆
- 及时补充保证金: 监控保证金率，及时追加
- 设置止损: 使用止损单控制风险
- 分散仓位: 不要将所有资金集中在一个仓位
- 关注市场: 密切关注市场波动和资金费率
说明
- 清算是自动执行的，无需人工干预
- 清算价格在开仓时就已确定
- 可以通过增加保证金来降低清算价格
- 清算记录公开透明，任何人都可以查询
- 保险基金余额实时更新
相关接口
- 仓位管理 - 查看仓位清算价格
- 自动减仓 (ADL) - 了解 ADL 机制
- 账户余额 - 管理保证金