自动减仓 (ADL - Auto-Deleveraging)

自动减仓（Auto-Deleveraging, ADL）是在发生强制平仓且保险基金不足以弥补损失时，系统为了保护整体用户利益，从对手方中根据排名挑选出盈利且高杠杆的仓位进行减仓的机制。

ADL 触发条件

ADL 只在以下情况下触发：

发生强制清算
清算价格劣于破产价格，产生穿仓损失
保险基金余额不足以弥补损失

ADL 排名机制

ZTDX 使用以下公式计算用户的 ADL 排名分数：

ADL Score = (PnL Weight × PnL %) + (Leverage Weight × Leverage) + (Size Weight × Normalized Size)

排名规则

只有盈利仓位 才会进入 ADL 队列
排名分数越高，被减仓的优先级越高
同一市场的多空两侧分别排名
减仓时从对手方（与被清算方相反方向）的队列顶部开始

权重配置

因子	权重	说明
PnL %	40%	未实现盈亏百分比
Leverage	30%	杠杆倍数
Size	30%	仓位大小（归一化）

优先级指标 (Risk Indicator)

系统提供 risk_indicator 字段，帮助用户识别被 ADL 的风险。

级别	颜色	风险	排名范围	说明
5	🔴 红色	极高	Top 0-20%	极大概率被 ADL
4	🟠 橙色	高	20-40%	高概率被 ADL
3	🟡 黄色	中	40-60%	可能被 ADL
2	🟢 绿色	低	60-80%	较少被 ADL
1	🔵 蓝色	极低	80-100%	基本不会被 ADL

获取 ADL 配置

接口信息

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

路径参数

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

响应示例

{
  "symbol": "BTCUSDT",
  "pnl_weight": "0.40",
  "leverage_weight": "0.30",
  "size_weight": "0.30",
  "min_pnl_percentage": "0.01",
  "enabled": true,
  "updated_at": "2024-01-01T00:00:00Z"
}

响应字段说明

字段	类型	描述
symbol	string	交易对
pnl_weight	string	PnL 权重
leverage_weight	string	杠杆权重
size_weight	string	仓位大小权重
min_pnl_percentage	string	最小盈利百分比（进入队列门槛）
enabled	boolean	是否启用 ADL
updated_at	string	更新时间

获取 ADL 排名

接口信息

Method: GET
Path: /api/v1/adl/:symbol/rankings
Authentication: 不需要

路径参数

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

查询参数

参数	类型	必须	描述
side	string	是	方向（long/short）
limit	number	否	返回数量（默认 50）

响应示例

{
  "market_symbol": "BTCUSDT",
  "side": "long",
  "rankings": [
    {
      "rank": 1,
      "user_address": "0x742d...0beb",
      "position_size": "10000.00",
      "leverage": 50,
      "pnl_percentage": "25.5",
      "adl_score": "85.2",
      "risk_indicator": 5
    },
    {
      "rank": 2,
      "user_address": "0x123d...0abc",
      "position_size": "8000.00",
      "leverage": 40,
      "pnl_percentage": "20.0",
      "adl_score": "78.5",
      "risk_indicator": 5
    }
  ]
}

响应字段说明

字段	类型	描述
market_symbol	string	交易对
side	string	方向（long/short）
rankings	array	排名列表

AdlRanking 对象字段

字段	类型	描述
rank	number	排名（1 为最高风险）
user_address	string	用户地址（部分隐藏）
position_size	string	仓位大小（USD）
leverage	number	杠杆倍数
pnl_percentage	string	未实现盈亏百分比
adl_score	string	ADL 分数
risk_indicator	number	风险指标（1-5）

获取 ADL 事件历史

接口信息

Method: GET
Path: /api/v1/adl/:symbol/events
Authentication: 不需要

路径参数

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

查询参数

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

响应示例

{
  "events": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "symbol": "BTCUSDT",
      "side": "long",
      "trigger_liquidation_id": "550e8400-e29b-41d4-a716-446655440001",
      "total_reduced_size": "50000.00",
      "affected_users": 15,
      "insurance_fund_deficit": "5000.00",
      "occurred_at": "2024-01-01T00:00:00Z"
    }
  ]
}

响应字段说明

字段	类型	描述
events	array	ADL 事件列表

AdlEvent 对象字段

字段	类型	描述
id	string	事件 ID
symbol	string	交易对
side	string	被减仓方向
trigger_liquidation_id	string	触发清算的 ID
total_reduced_size	string	总减仓规模（USD）
affected_users	number	受影响用户数
insurance_fund_deficit	string	保险基金缺口
occurred_at	string	发生时间

获取个人 ADL 历史

接口信息

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

查询参数

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

响应示例

{
  "reductions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "symbol": "BTCUSDT",
      "position_id": "550e8400-e29b-41d4-a716-446655440001",
      "adl_event_id": "550e8400-e29b-41d4-a716-446655440002",
      "side": "long",
      "reduced_size": "5000.00",
      "reduction_price": "65500.00",
      "pnl_realized": "500.00",
      "rank_at_reduction": 5,
      "occurred_at": "2024-01-01T00:00:00Z"
    }
  ]
}

响应字段说明

字段	类型	描述
reductions	array	减仓记录列表

AdlReduction 对象字段

字段	类型	描述
id	string	减仓记录 ID
symbol	string	交易对
position_id	string	仓位 ID
adl_event_id	string	ADL 事件 ID
side	string	仓位方向
reduced_size	string	减仓规模（USD）
reduction_price	string	减仓价格
pnl_realized	string	已实现盈亏
rank_at_reduction	number	减仓时的排名
occurred_at	string	发生时间

获取用户 ADL 统计

接口信息

Method: GET
Path: /api/v1/adl/:symbol/stats
Authentication: 需要身份验证

路径参数

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

响应示例

{
  "stats": {
    "symbol": "BTCUSDT",
    "user_address": "0x742d35cc6634c0532925a3b844bc9e7595f0beb",
    "current_rank": 25,
    "total_participants": 100,
    "adl_score": "65.5",
    "risk_indicator": 3,
    "total_adl_events": 2,
    "total_reduced_size": "10000.00",
    "total_pnl_from_adl": "1000.00",
    "last_adl_at": "2024-01-01T00:00:00Z"
  }
}

响应字段说明

字段	类型	描述
stats	object \| null	统计信息（无仓位时为 null）

UserAdlStats 对象字段

字段	类型	描述
symbol	string	交易对
user_address	string	用户地址
current_rank	number	当前排名
total_participants	number	总参与者数
adl_score	string	ADL 分数
risk_indicator	number	风险指标（1-5）
total_adl_events	number	历史 ADL 次数
total_reduced_size	string	累计减仓规模
total_pnl_from_adl	string	累计 ADL 盈亏
last_adl_at	string \| null	最后一次 ADL 时间

如何降低 ADL 风险

降低杠杆: 使用较低的杠杆倍数
及时止盈: 不要让未实现盈亏过高
分批平仓: 逐步减小仓位规模
监控排名: 定期查看 ADL 排名和风险指标
多样化策略: 避免过度集中在单一方向

ADL 补偿

被 ADL 的用户会获得市场最优价格
减仓价格通常优于用户的破产价格
已实现的盈亏会立即结算到账户余额
不收取额外的手续费

说明

ADL 是保护系统整体安全的最后手段
只有在保险基金不足时才会触发
ADL 事件相对罕见，通常发生在极端市场波动时
排名和风险指标实时更新
所有 ADL 事件公开透明，可供查询

自动减仓 (ADL - Auto-Deleveraging)

ADL 触发条件​

ADL 排名机制​

排名规则​

权重配置​

优先级指标 (Risk Indicator)​

获取 ADL 配置​

接口信息​

路径参数​

响应示例​

响应字段说明​

获取 ADL 排名​

接口信息​

路径参数​

查询参数​

响应示例​

响应字段说明​

AdlRanking 对象字段​

获取 ADL 事件历史​

接口信息​

路径参数​

查询参数​

响应示例​

响应字段说明​

AdlEvent 对象字段​

获取个人 ADL 历史​

接口信息​

查询参数​

响应示例​

响应字段说明​

AdlReduction 对象字段​

获取用户 ADL 统计​

接口信息​

路径参数​

响应示例​

响应字段说明​

UserAdlStats 对象字段​

如何降低 ADL 风险​

ADL 补偿​

说明​

相关接口​

ADL 触发条件

ADL 排名机制

排名规则

权重配置

优先级指标 (Risk Indicator)

获取 ADL 配置

接口信息

路径参数

响应示例

响应字段说明

获取 ADL 排名

接口信息

路径参数

查询参数

响应示例

响应字段说明

AdlRanking 对象字段

获取 ADL 事件历史

接口信息

路径参数

查询参数

响应示例

响应字段说明

AdlEvent 对象字段

获取个人 ADL 历史

接口信息

查询参数

响应示例

响应字段说明

AdlReduction 对象字段

获取用户 ADL 统计

接口信息

路径参数

响应示例

响应字段说明

UserAdlStats 对象字段

如何降低 ADL 风险

ADL 补偿

说明

相关接口