Perpetuals API

One coin's liquidations over the last hour to day, venue by venue

A coin's derivatives liquidations over the last 1, 4, 12 or 24 hours, long and short apart, in US dollars, on each venue and in total.

GET/api/external/perps/derivatives-liquidations/{symbol}

Get a free API key Try it in the API reference

What it returns

One coin's derivatives liquidations over the last hour, 4 hours, 12 hours or 24 hours, long and short apart, in US dollars: the total across venues, and one row per venue the breakdown covers, largest first; a venue with no liquidation in the window reads 0. symbol is the coin ticker (e.g. "BTC"), matched case-insensitively — not an instrument id, not a token mint or contract address, and not scoped to any of this API's chains. A ticker with no liquidation breakdown 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-liquidations/<symbol>"

Parameters
Parameter	Description
`window` query · string · optional	The trailing window: 1h, 4h, 12h or 24h, ending now. Defaults to 24h.`1h4h12h24h`
`symbol` path · string · required	The coin (base asset) ticker, e.g. "BTC" or "kPEPE" — 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 One coin's liquidations over the last hour to day, venue by venue
Field	Type	Description
`symbol`	string	The coin ticker, upper-cased (e.g. "BTC", "KPEPE").
`window`	string	The trailing window.
`total`	object \| null	The figures summed across every venue. null when no total was stated.
`total.liquidated`	number \| null	Long and short positions liquidated over the window together, US dollars. null when not stated.
`total.long`	number \| null	Long positions liquidated over the window, US dollars. null when not stated.
`total.short`	number \| null	Short positions liquidated over the window, US dollars. null when not stated.
`venues`	object[]	One row per venue, by `liquidated` descending; venues without that figure last.
`venues[].venue`	string	The trading venue, e.g. "Binance" or "Hyperliquid".
`venues[].liquidated`	number \| null	Long and short positions liquidated over the window together, US dollars. null when not stated.
`venues[].long`	number \| null	Long positions liquidated over the window, US dollars. null when not stated.
`venues[].short`	number \| null	Short positions liquidated over the window, US dollars. null when not stated.

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 cross-venue long and short totals as buckets over time.
One coin's open interest right now, venue by venue and in total
The open positions left on each venue right now.
One coin's futures markets across venues: funding, open interest, volume
The same coin's liquidations over the last 24 hours, split by funding-quoting market.
The coins liquidated the most on one exchange over the last hour to day
The same figures cut the other way: one coin on every exchange, against every coin on one exchange.
One coin's margin borrow rate on one exchange over time
The interest rate to borrow a coin on margin at one exchange, percent per day, per hour, 4 hours or day, oldest first.
One coin's options open interest and volume, venue by venue
A coin's options open interest in contracts and USD on each venue and in total, with each venue's share, its 24-hour change and its 24-hour volume.

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