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.

GET/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>"
Parameters
ParameterDescription
limit

query · 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.
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 daily derivatives trading volume, venue by venue, over time
FieldTypeDescription
symbolstringThe coin, spelled as it is listed (e.g. "BTC", "kPEPE").
daysobject[]Oldest first; full UTC days only.
days[].atnumberThe day's open, 00:00 UTC, unix seconds.
days[].totalUsdnumberThe sum of the venues' volumes that day, US dollars, rounded to 4 decimal places.
days[].venuesobject[]Every venue that states a volume for the coin that day, largest first, ties by name.
days[].venues[].venuestringThe venue (e.g. "Binance", "Crypto.com", "CME"). Compare venue names case-insensitively.
days[].venues[].volumeUsdnumberThe 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