Discovery and markets API

Volume footprint for one coin on one exchange: taker buys and sells by price

A coin's taker buy and sell volume in each price bucket inside each candle, on one exchange's futures or spot market, in coin units, US dollars and trade counts. Keyed by coin ticker.

GET/api/external/discovery/volume-footprint/{symbol}

Get a free API key Try it in the API reference

What it returns

A volume footprint (a footprint chart's data): inside each candle, the taker buy and taker sell volume that traded in each price bucket of one coin's market on one exchange, oldest candle first. market picks perpetual futures or spot; futures on Binance, OKX, Bybit or Hyperliquid, spot on Binance, OKX, Bybit or Coinbase. instrument names the exchange's instrument, else the main USD-margined perpetual or USDT pair (USD on Coinbase) for the coin. Each level is [priceLow, priceHigh, buyQuantity, sellQuantity, buyUsd, sellUsd, buyTrades, sellTrades]: quantities in units of the coin, values in US dollars, trade counts; the bucket width is the exchange data's own (e.g. 5 US dollars for bitcoin on one-hour candles). buyUsd and sellUsd on the candle sum its levels. A candle with no recorded footprint has levels, buyUsd and sellUsd null — not zero volume. The newest candle is normally still trading (complete: false). An answer may be served from a cache up to a few minutes old. An instrument that is not recorded 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/discovery/volume-footprint/<symbol>"

Parameters
Parameter	Description
`market` query · string · optional	futures (perpetual futures trades) or spot. Defaults to futures.`futuresspot`
`venue` query · string · optional	The exchange, spelled as listed: Binance, OKX, Bybit or Hyperliquid for futures; Binance, OKX, Bybit or Coinbase for spot. Defaults to Binance.`BinanceOKXBybitHyperliquidCoinbase`
`interval` query · string · optional	The candle width. Defaults to one hour.`1m15m1h4h1d`
`limit` query · integer · optional	How many of the most recent candles to return, the one still trading included, 1 to 100. Defaults to 24.
`instrument` query · string · optional	The exchange's instrument id, e.g. "BTCUSDT" on Binance or Bybit, "BTC-USDT-SWAP" (futures) or "BTC-USDT" (spot) on OKX, "BTC-USD" on Hyperliquid or Coinbase. Sent as given. Omitted: the main USD-margined perpetual (futures) or USDT pair (USD on Coinbase) for the coin.
`symbol` path · string · required	The coin (base asset) ticker, e.g. "BTC" or "ETH" — not a venue instrument id such as "BTCUSDT" (that goes in `instrument`), 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 Volume footprint for one coin on one exchange: taker buys and sells by price
Field	Type	Description
`symbol`	string	The coin ticker, upper-cased.
`market`	string	futures or spot.
`venue`	string	The exchange.
`instrument`	string	The exchange's instrument id the trades are of.
`interval`	string	The candle width.
`candles`	object[]	Oldest first.
`candles[].at`	number	The candle's open, unix seconds.
`candles[].complete`	boolean	Whether the candle has closed. false only on the newest, when it was still trading as the figures were read.
`candles[].buyUsd`	number \| null	Taker buys in the candle, all levels, US dollars; null when no footprint was recorded for it.
`candles[].sellUsd`	number \| null	Taker sells in the candle, all levels, US dollars; null when no footprint was recorded for it.
`candles[].levels`	number[][] \| null	[priceLow, priceHigh, buyQuantity, sellQuantity, buyUsd, sellUsd, buyTrades, sellTrades] per price bucket, lowest price first: taker buys and sells that traded from priceLow up to priceHigh, in units of the coin, in US dollars, and as counts of trades. null when no footprint was recorded for the candle.

Price per call

Every call: 6 credits

Charged only when the call succeeds. Prices as of 2026-10-30; the current ones are always in the API reference.

Volume footprint brief: where a coin traded most, per candle and overall
The same answer in a compact response
One coin's taker buy and sell volume on perps, summed across venues, over time
Taker buys and sells split by price inside each candle on one exchange, or totalled per interval.
One coin's spot taker buy and sell volume, summed across exchanges, over time
Spot taker buys and sells split by price inside each candle on one exchange, or totalled per interval.
Order book heatmap for one coin on one exchange: resting orders by price
Where trades actually filled by price, against where orders rested by price.
Order book heatmap brief: largest resting bids and asks over time
Where orders rested by price, against where trades actually filled by price.
Where does this coin trade, and how deep and liquid is each market?
Every spot market of one coin, centralized and on-chain, by 24h volume: venue, pair, price, volume, spread and 2% depth, with outlier and stale flags. Paged.

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