Perpetuals API
One coin's daily derivatives trading volume, venue by venue, over time
A coin's perpetual and dated futures trading volume per UTC day on each tracked derivatives venue, with the day's total, in US dollars, for up to the last 1000 full days.
/api/external/perps/derivatives-volume-history/{symbol}What it returns
One coin's derivatives trading volume over time: per UTC day, oldest first, the US-dollar volume traded in the coin's perpetuals and dated futures together on each tracked venue that reports it, largest first, with their total — a total over those venues, not the whole market. Full days only: the day in progress is never included, and the newest day is yesterday once its figures are published (until then, or from a cached answer, it can be the day before). A venue with no figure for a day, such as one that did not list the coin yet, is left out of that day, and a day no venue states is left out, so days can skip. Each figure is the venue's own daily total as the venue states it: it can differ by about a percent from a sum of the same day's candles, a venue closed at weekends (CME) can still state weekend volume, and a one-day spike is passed through unsmoothed. An answer may be served from a short-lived cache. 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. An unknown ticker 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-volume-history/<symbol>"
| Parameter | Description |
|---|---|
limitquery · integer · optional | How many of the most recent full days to return, 1 to 1000. Defaults to 30. Fewer come back when the coin's history is shorter or a day carries no figures. limit ≤ 30 keeps the answer under 32 KB. |
symbolpath · 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.
| Field | Type | Description |
|---|---|---|
symbol | string | The coin, spelled as it is listed (e.g. "BTC", "kPEPE"). |
days | object[] | Oldest first; full UTC days only. |
days[].at | number | The day's open, 00:00 UTC, unix seconds. |
days[].totalUsd | number | The sum of the venues' volumes that day, US dollars, rounded to 4 decimal places. |
days[].venues | object[] | Every venue that states a volume for the coin that day, largest first, ties by name. |
days[].venues[].venue | string | The venue (e.g. "Binance", "Crypto.com", "CME"). Compare venue names case-insensitively. |
days[].venues[].volumeUsd | number | The coin's futures volume on that venue that day, US dollars. A venue that traded none states 0. |
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