Perpetuals API
The coins liquidated the most on one exchange over the last hour to day
Every coin liquidated on one derivatives exchange over the last 1, 4, 12 or 24 hours, long and short apart, in USD, largest first, with the exchange total.
/api/external/perps/derivatives-venue-liquidationsWhat it returns
Every coin liquidated on one derivatives exchange over the last hour, 4 hours, 12 hours or 24 hours, long and short apart, in US dollars, largest first, with the exchange's total across every coin. venue is the exchange, spelled exactly as listed. A symbol here is the exchange's own ticker for the coin (e.g. "BTC", "kPEPE"), never a token mint or contract address on any of this API's chains. coinCount is how many coins the exchange states a figure for; limit keeps the top ones, total counts them all. A coin with no liquidation in the window reads 0.
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-venue-liquidations?venue=Binance"
| Parameter | Description |
|---|---|
venuequery · string · required | The exchange, spelled exactly as listed (case-sensitive).BinanceBybitOKXGateBitgetHyperliquidAsterHTXLighterBitfinex |
windowquery · string · optional | The trailing window: 1h, 4h, 12h or 24h, ending now. Defaults to 24h.1h4h12h24h |
limitquery · integer · optional | How many coins to return, from the top. Defaults to 100; at most 1000. limit ≤ 450 keeps the answer under 32 KB. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
venue | string | The exchange. |
window | string | The trailing window. |
coinCount | integer | How many coins the exchange states a figure for in the window, before limit. |
total | object | The figures summed over every coin counted in coinCount, not only those listed. Each null when no coin states it. |
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. |
coins | object[] | By liquidated descending, coins without that figure last, ties by symbol; at most limit. |
coins[].symbol | string | The exchange's ticker for the coin, as the exchange spells it (e.g. "BTC", "kPEPE"). |
coins[].liquidated | number | null | Long and short positions liquidated over the window together, US dollars. null when not stated. |
coins[].long | number | null | Long positions liquidated over the window, US dollars. null when not stated. |
coins[].short | number | null | Short positions liquidated over the window, US dollars. null when not stated. |
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