Discovery and markets API

Volume footprint brief: where a coin traded most, per candle and overall

A coin's taker buys and sells on one exchange: totals, the busiest price bucket per candle and the busiest buckets overall. A few KB.

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

Get a free API key Try it in the API reference

What it returns

The brief of volume-footprint; prefer it unless you need every bucket of every candle. Same parameters, defaults and 400s/404s. It keeps the market identity, sums taker buys and sells over the candles, gives each candle its totals and its busiest bucket (most US dollars, buys plus sells), and lists the 10 buckets with the most US dollars over the whole answer, each summed across candles. A bucket is [priceLow, priceHigh, buyQuantity, sellQuantity, buyUsd, sellUsd, buyTrades, sellTrades], as in the full answer.

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-brief/<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 brief: where a coin traded most, per candle and overall
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.
`buyUsd`	number \| null	Taker buys over every candle with a footprint, US dollars; null when none has one.
`sellUsd`	number \| null	Taker sells over every candle with a footprint, US dollars; null when none has one.
`candles`	object[]	Every candle of the full answer, oldest first, without its buckets.
`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[].busiestLevel`	number[] \| null	The candle's bucket with the most US dollars traded, buys plus sells, [priceLow, priceHigh, buyQuantity, sellQuantity, buyUsd, sellUsd, buyTrades, sellTrades]; null when no footprint was recorded for it.
`levels`	number[][]	Up to 10 buckets with the most US dollars traded over every candle, most first, [priceLow, priceHigh, buyQuantity, sellQuantity, buyUsd, sellUsd, buyTrades, sellTrades], each figure summed across the candles. Empty when no candle has a footprint.

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 for one coin on one exchange: taker buys and sells by price
The full answer this one condenses
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.
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.
Coin markets brief: the largest spot markets of a coin
The 25 largest spot markets of a coin by 24h volume, with price, spread and depth, plus market and venue counts.

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