Perpetuals API

Price levels where one coin's leveraged positions would be liquidated

Price levels where a coin's leveraged positions would be liquidated, in US dollars, across major exchanges or on one exchange split by leverage. Keyed by coin ticker.

GET/api/external/perps/derivatives-liquidation-levels/{symbol}

Get a free API key Try it in the API reference

What it returns

A model of where one coin's leveraged derivatives positions would be force-liquidated: price levels, each with the US dollars of positions that would be liquidated there, summed across the centralized venues the coin is modelled on and split by venue. Levels below price would liquidate longs if the price fell to them, levels above it shorts if it rose. range selects the window: 1d, 7d or 30d; a longer one spans a wider band of prices. venue (with an optional instrument, else the venue's main perpetual for the coin) narrows the map to that one venue instrument's own model, Hyperliquid included, always in US dollars; only then is each level, and the whole map, also split by the leverage of the positions (byLeverage), and quote is null. The levels are a model, not a record of real stop or liquidation orders. symbol is the coin ticker (e.g. "BTC"), matched case-insensitively. A coin, or a venue instrument, that is not modelled answers 404.

Chains

This endpoint is not tied to a chain: it takes no chain in its request.

Request

Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.

curl -H "x-dex-data-key: $DEXDATA_API_KEY" \
  "https://api.dexdata.io/api/external/perps/derivatives-liquidation-levels/<symbol>"

Parameters
Parameter	Description
`range` query · string · optional	The window: 1d, 7d or 30d; a longer one spans a wider band of prices. Defaults to 1d. range=1d keeps the answer under 32 KB.`1d7d30d`
`venue` query · string · optional	One venue to map, spelled as listed. Omit it for the map summed across venues.`BinanceOKXBybitGateBitgetDeribitMEXCBingXKrakenHTXAsterHyperliquid`
`instrument` query · string · optional	The venue's instrument id, e.g. "BTCUSDT", "BTC-USDT-SWAP" or "BTC-USD" on Hyperliquid; case-insensitive. Only with `venue`; omitted, the venue's main perpetual for the coin.
`symbol` path · string · required	The coin (base asset) ticker, e.g. "BTC" or "SOL" — not a venue instrument id such as "BTCUSDT" (that goes in `instrument`), and not a token mint or contract address. Case-insensitive.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of Price levels where one coin's leveraged positions would be liquidated
Field	Type	Description
`symbol`	string	The coin ticker, upper-cased.
`range`	string	The window asked for.
`price`	number	The last price reported with the levels, which divides the long levels from the short ones.
`longUsd`	number	Summed over every level below the price: the long positions a fall through all of them would liquidate, US dollars.
`shortUsd`	number	Summed over every level above the price: the short positions a rise through all of them would liquidate, US dollars.
`venues`	object[]	The venues the coin is modelled on, with their totals on each side of the price.
`venues[].venue`	string	The exchange.
`venues[].instrument`	string	The venue's instrument id the positions are in, e.g. "BTCUSDT".
`venues[].quote`	string \| null	The instrument's quote currency, e.g. "USDT". null when not stated, and always with `venue`.
`venues[].longUsd`	number	This venue's levels below the price, summed, US dollars.
`venues[].shortUsd`	number	This venue's levels above the price, summed, US dollars.
`levels`	object[]	Lowest price first. Only prices at which some venue models liquidations are present.
`levels[].price`	number	The price level.
`levels[].side`	string \| null	long: below the price, so a fall to it would liquidate long positions; short: above it, so a rise would liquidate short positions; null for a level exactly at the price.
`levels[].usd`	number	Positions that would be liquidated at this level, summed across the venues listed, US dollars.
`levels[].venues`	object[]	Each venue's part of the level; a venue that models nothing at this price is absent.
`levels[].venues[].venue`	string	The exchange.
`levels[].venues[].instrument`	string	The venue's instrument id.
`levels[].venues[].usd`	number	Positions on this venue that would be liquidated at the level, US dollars.
`levels[].byLeverage`	object[]	Present only when `venue` is given: the level split by the leverage of the positions, lowest leverage first (not stated last). The parts add up to `usd`.
`levels[].byLeverage[].leverage`	number \| null	The leverage of the positions, e.g. 10 for 10x; null when not stated.
`levels[].byLeverage[].usd`	number	Positions of this leverage that would be liquidated at the level, US dollars.
`byLeverage`	object[]	Present only when `venue` is given: the totals on each side of the price split by the leverage of the positions, lowest leverage first (not stated last). Each side adds up to `longUsd` and `shortUsd`.
`byLeverage[].leverage`	number \| null	The leverage of the positions, e.g. 10 for 10x; null when not stated.
`byLeverage[].longUsd`	number	Positions of this leverage below the price, summed, US dollars.
`byLeverage[].shortUsd`	number	Positions of this leverage above the price, summed, US dollars.

Price per call

Every call: 6 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

One coin's long and short liquidations summed across venues, over time
What was actually liquidated over time, against where positions would be liquidated now.
One coin's open interest across all venues, as candles over time
The open positions in the same coin, over time.
Liquidation levels for one perpetual-futures market
The same kind of map for one perpetual market, bucketed by price range, rather than summed across centralized exchanges.
Liquidation heatmap for one coin: modelled liquidations by price, over time
The same liquidation model over time as a heatmap, or at one instant split by exchange.
Liquidation heatmap brief: strongest liquidation levels above and below price
The strongest modelled levels around the price now, or the model at one instant split by exchange.
Max-pain liquidation level, per coin
The whole modelled liquidation price curve for ONE already-known coin, not one level across every coin.

Start building with DexData today

Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.

Get a free API key