Gate API Upgrade : New ADL Risk Alerts for Futures

To help users manage Futures market risk more efficiently, Gate now supports querying ADL risk states via the REST API and subscribing to ADL risk alerts via WebSocket, making it easier to monitor the ADL risk status of each market.

1. Release Details

1.1 REST

• New Endpoint: GET /api/v4/futures/{settle}/adl_risk_states

• Parameter settle：usdt / btc / usd1

1.2 WebSocket

• New Public channel: futures.adl_warning

  • Supports subscribing to specified contract markets.

  • Use !all to subscribe to all contracts under the current settlement currency.

  • While the risk state is warning or adl_risk , updates are pushed once per second.

  • When the risk state returns to normal , the update is pushed only once.

  • On the first subscription, if the contract is normal , no initial snapshot is sent.

2. Request and Response Examples

2.1 REST

• Request:

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

• Response (all markets returned; middle entries omitted):

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

2.2 WebSocket

• Subscription:

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

• Push example:

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

• Notes:

  • On first subscription, if the contract is already in a risk state: an event=all snapshot is pushed first.

  • When the risk state changes, event=update is pushed; state may be warning, adl_risk, or normal.

  • state values:

    • normal : Normal

    • warning : Warning

    • adl_risk : ADL triggered

3. Documentation

• REST: https://www.gate.com/docs/developers/apiv4/en/futures/#list-market-level-adl-risk-states

• WebSocket: https://www.gate.com/docs/developers/futures/ws/en/#adl-risk-warning-api

If you have any questions, please feel free to contact us.

Gate Team
August 31, 2026

Gateway to Crypto
Trade over 5,000 cryptocurrencies safely, quickly, and easily on Gate
Take Action Now
Sign up and claim up to $10,000 in welcome rewards
Invite friends and earn a 40% commission
Stay Connected
Visit Gate's official website
Download the Gate App | Desktop
Follow us on X (Twitter) to get more bonuses
Join our Telegram community to discuss trending topics
Engage with our global community for the latest insights
Transparency & Security
Check our 100% Proof of Reserves