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% 儲備金證明