Get ADL Alert

Query for ADL (auto-deleveraging mechanism) alerts and insurance pool information.

Covers: USDT Perpetual / USDT Delivery / USDC Perpetual / USDC Delivery / Inverse Contracts

info

• ADL trigger and stop conditions are based on the following three scenarios:

1. Contract PnL drawdown

   • Trigger condition: balance (insurance fund balance) > adlTriggerThreshold (trigger threshold for Contract PnL Drawdown ADL), and pnlRatio (8 hour drawdown ratio of the symbol) < insurancePnlRatio (PnL ratio threshold for triggering ADL).
   • Stop condition: pnlRatio (8 hour drawdown ratio of the symbol) > adlStopRatio (stop ratio threshold for ADL).

2. Insurance pool balance

   • Trigger condition: balance (insurance fund balance) ≤ 0
   • Stop condition: balance (insurance fund balance) > 0

3. Severe margin loss of a symbol within a grouped pool

   • To ensure overall pool safety, the risk team may remove the affected symbol from the grouped insurance pool and temporarily assign it to a separate insurance pool. This can happen manually or follow the automatic conditions described in point 2.

Subscribe to the ADL WebSocket topic for faster updates.

HTTP Request

GET /v5/market/adlAlert

Request Parameters

Parameter	Required	Type	Description
symbol	false	string	Contract name, e.g. BTCUSDT. Uppercase only

Response Parameters

Parameter	Type	Description
updateTime	string	Latest data update timestamp (ms)
list	array	Object
> coin	string	Token of the insurance pool
> symbol	string	Trading pair name
> balance	string	Balance of the insurance fund. Used to determine if ADL is triggered
> maxBalance	string	Maximum balance of the insurance pool in the last 8 hours
> insurancePnlRatio	string	PnL ratio threshold for triggering contract PnL drawdown ADL ADL is triggered when the symbol's PnL drawdown ratio in the last 8 hours exceeds this value
> pnlRatio	string	Symbol's PnL drawdown ratio in the last 8 hours. Used to determine whether ADL is triggered or stopped
> adlTriggerThreshold	string	Trigger threshold for contract PnL drawdown ADL This condition is only effective when the insurance pool balance is greater than this value; if so, an 8 hours drawdown exceeding n% may trigger ADL
> adlStopRatio	string	Stop ratio threshold for contract PnL drawdown ADL ADL stops when the symbol's 8 hours drawdown ratio falls below this value

---

Request Example

HTTP

GET /v5/market/adlAlert&symbol=BTCUSDT HTTP/1.1
Host: api-testnet.bybit.com

Python

Go

Java

Node.js

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "updatedTime": "1757733960000",
        "list": [
            {
                "coin": "USDT",
                "symbol": "BTCUSDT",
                "balance": "92203504694.99632",
                "maxBalance": "92231510324.75948",
                "insurancePnlRatio": "-0.3",
                "pnlRatio": "-0.560973",
                "adlTriggerThreshold": "10000",
                "adlStopRatio": "-0.25"
            }
        ]
    },
    "retExtInfo": {},
    "time": 1757734022014
}