Skip to main content
POST
/
api
/
v4
/
collateral-account
/
adl-quantile
ADL Quantile
curl --request POST \
  --url https://whitebit.com/api/v4/collateral-account/adl-quantile \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --header 'X-TXC-PAYLOAD: <api-key>' \
  --header 'X-TXC-SIGNATURE: <api-key>' \
  --data '
{
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
[
  {
    "market": "BTC_PERP",
    "long": 0,
    "short": null
  },
  {
    "market": "ETH_PERP",
    "long": 2,
    "short": 1
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.whitebit.com/llms.txt

Use this file to discover all available pages before exploring further.

Authentication

Signed (HMAC-SHA512). Provide an API key, payload, and request signature on every call. See Authentication.

Rate limit

Cache

No caching.

Notes

The endpoint returns entries for perpetual markets only — markets with the _PERP suffix. Spot and margin markets are excluded from the response. The response is [] when the account has no open perpetual positions. See ADL Grade for the meaning of the 04 quantile values and the underlying selection mechanics.

Authorizations

X-TXC-APIKEY
string
header
required

The public WhiteBIT API key.

X-TXC-PAYLOAD
string
header
required

Base64-encoded JSON request body.

X-TXC-SIGNATURE
string
header
required

HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).

Body

application/json
request
string
required
Example:

"{{request}}"

nonce
string
required
Example:

"{{nonce}}"

Response

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

market
string

Perpetual market name. Format: BASE_PERP.

Example:

"BTC_PERP"

long
integer | null

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.

Required range: 0 <= x <= 4
Example:

0

short
integer | null

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.

Required range: 0 <= x <= 4
Example:

null