dexdataSign in

Perpetuals API

One venue derivatives instrument's price candles with traded volume

OHLC price candles with USD volume for one perpetual or dated future on one venue, 1m to 1w per candle, oldest first.

GET/api/external/perps/derivatives-ohlcv/{symbol}
Get a free API keyTry it in the API reference

What it returns

One venue's price candles for one derivatives instrument — open, high, low and close, with the USD volume traded in each candle — oldest first. Prices are in the instrument's quote currency: US dollars or a dollar stablecoin on most, but BTC on a coin-quoted one such as ETHBTC. The newest candle is normally the one still in progress when the figures were read (complete: false). symbol is the venue's instrument id, spelled exactly as listed (case-sensitive) — take venue and instrument from a derivatives-coin-venues row. Dated futures answer too, by the venue's own id (e.g. "BTC-25SEP26" on Deribit), though derivatives-coin-venues lists perpetuals only. An instrument the venue does not list, in that spelling, 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-ohlcv/<symbol>?venue=Binance"
Parameters
ParameterDescription
venue

query · string · required

The trading venue, spelled exactly as listed (case-sensitive), as derivatives-coin-venues names it.BinanceOKXBybitGateMEXCCoinbaseHyperliquidBitgetBitunixWhiteBITDeribitBingXAsterLighterLBankKrakenApeX OmniHTXCrypto.comKuCoinExtendedBitfinexdYdXParadex
interval

query · string · optional

Candle width. Defaults to one day.1m3m5m15m30m1h4h6h8h12h1d1w
limit

query · integer · optional

How many of the most recent candles to return, 1 to 1000. Defaults to 100. Fewer come back when the instrument's history is shorter or a candle carries no figures. limit ≤ 250 keeps the answer under 32 KB.
symbol

path · string · required

The venue's own instrument id, exactly as instrument in derivatives-coin-venues rows, case included: e.g. "BTCUSDT" (Binance, Bybit), "BTC-USDT-SWAP" (OKX), "BTC_USDT" (Gate), "tBTCF0:USTF0" (Bitfinex) — not a bare coin ticker such as "BTC", and not a token mint or contract address. Case-sensitive.

Response fields

A JSON response. Every field is always present; null means the value could not be established, never zero.

Response fields of One venue derivatives instrument's price candles with traded volume
FieldTypeDescription
venuestringThe trading venue.
instrumentstringThe instrument id, exactly as asked.
intervalstringThe candle width.
candlesobject[]Oldest first.
candles[].atnumberThe candle's open, unix seconds.
candles[].opennumber | nullPrice at the open, in the instrument's quote currency. null when not stated.
candles[].highnumber | nullHighest price in the candle, in the quote currency. null when not stated.
candles[].lownumber | nullLowest price in the candle, in the quote currency. null when not stated.
candles[].closenumber | nullPrice at the close — for the candle in progress, the latest price — in the quote currency. null when not stated.
candles[].volumeUsdnumber | nullUSD volume traded on the instrument in the candle. null when not stated.
candles[].completebooleanWhether the figures are final. false only on the newest candle, which was still in progress when its figures were read.

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