Perpetuals API
Derivatives leaders across venues: open interest, volume, funding, liquidations
The coins with the most futures open interest across derivatives venues, each with 24h volume, funding rate, liquidations and price change. Keyed by ticker.
/api/external/perps/derivatives-coinsWhat it returns
A cross-venue derivatives ranking: every row is one coin aggregated across the futures venues this endpoint covers, ordered by open interest descending. No chain and no token subject in the request. A symbol here is a derivatives ticker (e.g. "BTC", and also commodities and indices such as "XAU"), never a token mint or contract address on any of this API's chains. Funding rates and every change figure are percentages.
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-coins"
| Parameter | Description |
|---|---|
limitquery · integer · optional | How many coins to return, from the top. Defaults to 20; at most 100. limit ≤ 50 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 |
|---|---|---|
coins | object[] | |
coins[].symbol | string | The derivatives ticker, e.g. "BTC". Not a token mint or contract address. |
coins[].priceUsd | number | null | Current price, USD. |
coins[].marketCapUsd | number | null | Market capitalisation, USD. null for instruments with no supply to cap (commodities, indices). |
coins[].openInterestUsd | number | null | Open interest across venues, USD. The ranking key. |
coins[].openInterestChangePercent1h | number | null | Open-interest change over the last hour, percent. |
coins[].openInterestChangePercent24h | number | null | Open-interest change over the last 24 hours, percent. |
coins[].volumeUsd24h | number | null | Derivatives trading volume across venues over the last 24 hours, USD. |
coins[].volumeChangePercent24h | number | null | Change of the 24-hour volume against the previous 24 hours, percent. |
coins[].fundingRatePercentOiWeighted | number | null | Funding rate averaged across venues, weighted by open interest, percent per funding interval as the venues quote it (8 hours on most). Venues settle on different intervals and the average is not normalised to one, so compare coins with it rather than annualising it. |
coins[].fundingRatePercentVolumeWeighted | number | null | Funding rate averaged across venues, weighted by volume, in the same unit as fundingRatePercentOiWeighted. |
coins[].priceChangePercent1h | number | null | Price change over the last hour, percent. |
coins[].priceChangePercent4h | number | null | Price change over the last 4 hours, percent. |
coins[].priceChangePercent24h | number | null | Price change over the last 24 hours, percent. |
coins[].liquidationsUsd1h | number | null | Liquidations over the last hour, long and short, USD. |
coins[].longLiquidationsUsd1h | number | null | Long liquidations over the last hour, USD. |
coins[].shortLiquidationsUsd1h | number | null | Short liquidations over the last hour, USD. |
coins[].liquidationsUsd24h | number | null | Liquidations over the last 24 hours, long and short, USD. |
coins[].longLiquidationsUsd24h | number | null | Long liquidations over the last 24 hours, USD. |
coins[].shortLiquidationsUsd24h | number | null | Short liquidations over the last 24 hours, USD. |
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