Perpetuals API

Liquidation levels for one perpetual-futures market

Where open positions in ONE perpetual-futures market would be liquidated, keyed by trading symbol. A risk map for a derivatives market, unrelated to a token's on-chain holders.

GET/api/external/perps/perps-liquidation-map/{symbol}

Get a free API key Try it in the API reference

What it returns

Buckets one market's open positions by the price at which they would be force-liquidated: how many positions, and how much long/short size and value, sit in each price range, plus a cumulative view walking outward from the current price. A real risk-map signal for a market under stress. Chainless — symbol is a market ticker (e.g. "BTC"), not a token mint or contract address. An unrecognised symbol returns 400 naming exactly that, rather than a blank 404. Use GET /perps/perps-markets to discover a real one.

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/perps-liquidation-map/<symbol>"

Parameters
Parameter	Description
`symbol` path · string · required	A coin ticker, e.g. "BTC" — the asset the market is on, not a token mint or contract address, and not scoped to any chain this API otherwise supports.

Response fields

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

Response fields of Liquidation levels for one perpetual-futures market
Field	Type	Description
`buckets`	object[]
`buckets[].lowPrice`	number \| null	Lower bound of this price bucket.
`buckets[].highPrice`	number \| null	Upper bound of this price bucket.
`buckets[].positionCount`	number \| null	Number of positions that would be affected inside this bucket.
`buckets[].longLiquidationSize`	number \| null	Total long position size exposed to liquidation within this bucket.
`buckets[].longLiquidationUsd`	number \| null	USD value of long liquidations within this bucket.
`buckets[].shortLiquidationSize`	number \| null	Total short position size exposed to liquidation within this bucket.
`buckets[].shortLiquidationUsd`	number \| null	USD value of short liquidations within this bucket.
`buckets[].cumulativeLongLiquidationSize`	number \| null	Cumulative long liquidation size from the current price toward this bucket.
`buckets[].cumulativeLongLiquidationUsd`	number \| null	Cumulative USD value of long liquidations from the current price toward this bucket.
`buckets[].cumulativeShortLiquidationSize`	number \| null	Cumulative short liquidation size from the current price toward this bucket.
`buckets[].cumulativeShortLiquidationUsd`	number \| null	Cumulative USD value of short liquidations from the current price toward this bucket.

Price per call

Every call: 80 credits

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

Open positions in one perpetual-futures market
The positions these levels would liquidate.
Liquidation heatmap for one coin: modelled liquidations by price, over time
A price-by-time liquidation heatmap for a coin, or one perpetual market's positions bucketed by liquidation price now.
One coin's long and short liquidations summed across venues, over time
Where open positions would be liquidated by price, not what was liquidated over time.
Price levels where one coin's leveraged positions would be liquidated
The same kind of map for one perpetual market, bucketed by price range, rather than summed across centralized exchanges.
One perpetual-futures market, by symbol
Where that market is exposed to liquidation.
Whale positions: perpetual positions over $1M open right now
Where a market's liquidations would cluster if price moved.

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