Perpetuals API

The newest liquidation orders in one coin's derivatives

Individual forced liquidations of leveraged positions in one coin: time, exchange, instrument, long or short, price and US dollars. Newest first, filterable by exchange and size.

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

Get a free API key Try it in the API reference

What it returns

The newest forced liquidations of leveraged positions in one coin's derivatives, one row per liquidation order: when, on which venue and instrument, whether a long or a short position was liquidated, at what price and for how many US dollars. At most 200, newest first, from the last 7 days; capped says older orders exist beyond the oldest one returned. Across every venue by default, or one with venue; minUsd leaves out smaller orders, which reaches further back. symbol is the coin ticker (e.g. "BTC"), matched case-insensitively. A listed coin with no liquidation answers an empty list; a ticker that is not listed 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-orders/<symbol>"

Parameters
Parameter	Description
`venue` query · string · optional	One exchange, spelled exactly as listed (case-sensitive). Omit for every venue.`AsterBinanceBitfinexBitgetBybitExtendedGateHTXHyperliquidLighterOKXParadex`
`minUsd` query · integer · optional	The smallest order to return, US dollars. Omit, or 0, for every size.
`symbol` path · string · required	The coin (base asset) ticker, e.g. "BTC" or "SOL" — not a venue instrument id such as "BTCUSDT", 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 The newest liquidation orders in one coin's derivatives
Field	Type	Description
`symbol`	string	The coin ticker, upper-cased.
`venue`	string \| null	The venue asked for; null for every venue.
`minUsd`	number \| null	The smallest order asked for, US dollars; null for every size.
`capped`	boolean	true when 200 orders came back, so older ones exist beyond the oldest here; false when the list is every order found.
`orders`	object[]	Newest first.
`orders[].at`	number	When the order hit, unix seconds.
`orders[].venue`	string	The exchange.
`orders[].instrument`	string	The venue's instrument id, e.g. "BTCUSDT" or "BTC-USDT-SWAP"; dated contracts included.
`orders[].side`	string	long: a long position was liquidated (forced to sell); short: a short position was (forced to buy).
`orders[].price`	number	The price the position was liquidated at.
`orders[].usd`	number	The value of the liquidated position, 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
The same liquidations summed per time bucket, over a longer span.
Price levels where one coin's leveraged positions would be liquidated
Where positions would be liquidated next, against the ones just liquidated.
One coin's derivatives taker net flow: buys minus sells, 5 minutes to 1 year
One coin's derivatives taker buys, taker sells and net flow over 22 windows from 5m to 1y, summed over Binance, OKX and Bybit, with net flow as a percent of market cap.
One coin's perpetual taker buying against selling over a window, by venue
A coin's perpetual taker buy and sell volume over the last 5 minutes to 24 hours, in US dollars: the total, the net flow, the buy share as a percent, and one row per venue.
One venue perpetual's long/short split over time: all accounts or top traders
How one venue's traders on one perpetual lean long versus short over time — all accounts, or top traders by account or by position — with the ratio, 1m to 1w per bucket.
One perpetual market's accounts long versus short over time
How many accounts on the perps venue are long and how many short one of its markets over time — counts, percents and the ratio, in 5-minute, hourly or daily buckets.

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