Discovery and markets API

Spot large orders brief: the biggest walls in a spot book

The 10 largest resting bid and ask walls of a coin's spot pair on one exchange, the rest's total, and the newest to leave.

GET/api/external/discovery/spot-large-orders-brief/{symbol}

Get a free API key Try it in the API reference

What it returns

The brief of spot-large-orders; prefer it unless you need every wall. The same coin, exchange, quote and limit. It lists the 10 largest resting bids and the 10 largest resting asks by value, highest price first, with how many other orders rest and their summed value, and the 10 orders that left the book most recently, each exactly as spot-large-orders lists it, with how many orders rest on each side and how many ended.

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/spot-large-orders-brief/<symbol>?venue=Binance"

Parameters
Parameter	Description
`venue` query · string · required	The exchange, spelled exactly as listed (case-sensitive), as spot-coin-venues names it.`BinanceBitfinexBybitCoinbaseKrakenOKX`
`quote` query · string · optional	The quote currency of the pair, e.g. "USDT" or "USD". Case-insensitive. Optional: without it, USDT, then USD, then USDC.
`limit` query · integer · optional	How many of the orders that left the book most recently to return, 1 to 200. Defaults to 50. Does not limit the resting orders.
`symbol` path · string · required	The coin (base asset) ticker, e.g. "BTC" or "SOL" — not a pair such as "BTCUSDT" or "BTC/USDT", 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 Spot large orders brief: the biggest walls in a spot book
Field	Type	Description
`symbol`	string	The coin ticker as the exchange lists it, e.g. "BTC" for "btc".
`venue`	string	The exchange.
`quote`	string	The currency every price and value is in, e.g. "USDT" or "USD".
`pair`	string	The pair, BASE/QUOTE, as spot-coin-venues prints it.
`staleOmitted`	integer	Resting orders left out because an opposite order updated later crossed their price, so they had already gone.
`restingCount`	integer	Orders resting now in the full answer.
`bidCount`	integer	Of them, bids.
`askCount`	integer	Of them, asks.
`resting`	object[]	The 10 largest resting bids and asks by value, highest price first; an order whose value is not stated ranks after every stated one.
`resting[].id`	string	An id for the order, stable across reads.
`resting[].side`	string	bid: an order to buy; ask: an order to sell.
`resting[].price`	number	The limit price, in `quote`.
`resting[].openedAt`	number \| null	When the order was first seen in the book, unix seconds. null when not stated.
`resting[].updatedAt`	number	When the order was last updated, unix seconds. An order that has not changed keeps an old time.
`resting[].endedAt`	number \| null	When the order left the book, unix seconds. null while it rests.
`resting[].initialQuantity`	number \| null	The quantity when first seen, in units of the coin. null when not stated.
`resting[].initialValue`	number \| null	initialQuantity times price, in `quote`. null when not stated.
`resting[].quantity`	number \| null	The quantity at the last update, in units of the coin. It can exceed initialQuantity when the order grew. null when not stated.
`resting[].value`	number \| null	quantity times price, in `quote`. null when not stated.
`resting[].filledQuantity`	number \| null	How much of it traded, in units of the coin. null when not stated.
`resting[].filledValue`	number \| null	The traded part times price, in `quote`. null when not stated.
`resting[].trades`	number \| null	How many trades filled part of it. null when not stated.
`resting[].status`	string	resting: still in the book; filled: left the book having traded some or all of it; pulled: left without trading.
`restingCutCount`	integer	Resting orders of the full answer not listed in `resting`.
`restingCutValue`	number \| null	The summed value of those orders, in `quote`. An order whose value is not stated is counted but not summed. 0 when none was left out; `null` when none of them states one.
`endedCount`	integer	Orders that left the book in the full answer, at most its `limit`.
`ended`	object[]	The 10 orders that left the book most recently, newest first.
`ended[].id`	string	An id for the order, stable across reads.
`ended[].side`	string	bid: an order to buy; ask: an order to sell.
`ended[].price`	number	The limit price, in `quote`.
`ended[].openedAt`	number \| null	When the order was first seen in the book, unix seconds. null when not stated.
`ended[].updatedAt`	number	When the order was last updated, unix seconds. An order that has not changed keeps an old time.
`ended[].endedAt`	number \| null	When the order left the book, unix seconds. null while it rests.
`ended[].initialQuantity`	number \| null	The quantity when first seen, in units of the coin. null when not stated.
`ended[].initialValue`	number \| null	initialQuantity times price, in `quote`. null when not stated.
`ended[].quantity`	number \| null	The quantity at the last update, in units of the coin. It can exceed initialQuantity when the order grew. null when not stated.
`ended[].value`	number \| null	quantity times price, in `quote`. null when not stated.
`ended[].filledQuantity`	number \| null	How much of it traded, in units of the coin. null when not stated.
`ended[].filledValue`	number \| null	The traded part times price, in `quote`. null when not stated.
`ended[].trades`	number \| null	How many trades filled part of it. null when not stated.
`ended[].status`	string	resting: still in the book; filled: left the book having traded some or all of it; pulled: left without trading.

Price per call

Every call: 17 credits

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

Large limit orders (walls) in one coin's spot book on one exchange
The full answer this one condenses
One coin's spot markets across exchanges: price, volume, taker buy/sell flow
Find which exchanges trade the coin, and in which quote, first.
One coin's spot price candles with traded volume on one exchange
The same pair's price candles, to see where the walls sit against the price.
How have DeFi fees, revenue or DEX volume moved, overall or by category?
Daily USD fees, revenue or DEX volume of all DeFi, or fees of one category (lending, DEXs, liquid staking, derivatives, launchpads, aggregators), over 7-365 days or all.
Which protocols earn the fees or DEX volume of a category or chain, over time?
Each protocol's daily USD fees, revenue or DEX volume within a DeFi category, on a chain, or both, largest first, over 7-365 days or all.
Protocol share history brief: the leading protocols of a category or chain
The 10 protocols earning the most fees, revenue or DEX volume of a DeFi category or chain, with totals and a few points.

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