v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB

Collateral Trading

ADL Quantile

The endpoint returns the Auto-Deleveraging (ADL) quantile for each perpetual market in which the authenticated account holds an open position. Each entry exposes the deleveraging-priority value for the long and short sides of the position, where 0 indicates the lowest deleveraging priority and 4 indicates the highest. The endpoint returns an empty array when the account has no perpetual positions.

<Warning> Rate limit: 12000 requests/10 sec. </Warning> <Note> Only perpetual markets (markets with the `_PERP` suffix) are returned. Spot and margin markets are not included. </Note>

post/api/v4/collateral-account/adl-quantile

Request body

requeststring required

nonceinteger required

Example request

{
  "request": "{{request}}",
  "nonce": 1594297865000
}

Response

Successful response — returns array of per-market ADL quantile entries

marketstring

Perpetual market name. Format: BASE_PERP.

longinteger nullable

ADL quantile for the long side of the position. Values range from 0 to 4: 0 indicates the lowest deleveraging priority (safest position in the ADL queue); 4 indicates the highest probability of being selected as the ADL counterparty. The value is null when the account has no exposure on the long side.

shortinteger nullable

ADL quantile for the short side of the position. Values range from 0 to 4: 0 indicates the lowest deleveraging priority; 4 indicates the highest probability of being selected as the ADL counterparty. The value is null when the account has no exposure on the short side.

Example response

[
  {
    "market": "BTC_PERP"
  }
]