Gate API 更新：合约新增 ADL 风险告警功能

为提升用户对合约市场的风险管理效率，Gate 现已支持通过 REST 接口查询和 WebSocket 订阅 ADL 风险告警通知，便于掌握各市场 ADL 风险状态。

1. 更新内容

1.1 REST API

• 新增查询合约 ADL 风险状态接口：

  • GET /api/v4/futures/{settle}/adl_risk_states

  • 参数 settle：usdt / btc / usd1

1.2 WebSocket API

• 新增公共频道: futures.adl_warning

  • 支持订阅指定合约市场。

  • 使用 !all 订阅当前结算币种下全部合约。

  • 当风险状态为 warning、adl_risk 时，每秒推送一次更新。

  • 当风险状态恢复为 normal 时只推送一次。

  • 首次订阅时，若合约为 normal ，不会推送首次快照。

2. 请求与响应示例

2.1 REST

• 请求示例

GET https://api.gateio.ws/api/v4/futures/usdt/adl_risk_states

• 响应示例

{
  "settle": "usdt",
  "states": {
    "BTC_USDT": { "state": "normal", "calculated_at_ms": 1786695185345 },
    "...": "...",
    "HYPE_USDT": { "state": "normal", "calculated_at_ms": 1786695185345 }
  }
}

2.2 WebSocket

• 订阅

{
  "time": 1781234567,
  "channel": "futures.adl_warning",
  "event": "subscribe",
  "payload": ["BTC_USDT"]
}

• 推送示例

  
  

  {"time": 1781234568,
  "time_ms": 1781234568123,
  "channel": "futures.adl_warning",
  "event": "update",
  "result": {
      "contract": "BTC_USDT",
      "settle": "usdt",
      "state": "adl_risk",
      "update_time": 1781234567000}
  }

• 说明：

  • 首次订阅且合约已处于风险状态：先推送 event=all 快照

  • 风险变化时：推送 event=update，state 为 warning / adl_risk / normal

  • state 枚举说明

    • normal ：正常状态

    • warning ：预警状态

    • adl_risk ：已开启 ADL

3. 相关文档

• REST: https://www.gate.com/docs/developers/apiv4/zh_CN/futures/#%E6%9F%A5%E8%AF%A2%E5%B8%82%E5%9C%BA%E7%BA%A7-adl-%E9%A3%8E%E9%99%A9%E7%8A%B6%E6%80%81

• WebSocket:
  https://www.gate.com/docs/developers/futures/ws/zh_CN/#adl-%E9%A3%8E%E9%99%A9%E9%A2%84%E8%AD%A6%E9%A2%91%E9%81%93

如有问题，欢迎联系我们。

Gate 团队
2026 年 8 月 31 日

加密货币之门
安全、快捷、轻松交易超过 5,000 种加密货币
立即行动
注册账户，最高可领 $10,000 迎新奖励
邀请他人注册，可获 40% 佣金
关注官方渠道
访问 Gate 官网
下载 Gate App | 电脑端
关注 X (Twitter)，获取最新福利
加入 Telegram 社群，讨论热点话题
进入全球社区，获取最新资讯
透明度保障
查看 100% 储备金证明