Discovery and markets API
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.
/api/external/discovery/coin-markets-briefWhat it returns
The brief of coin-markets; prefer it unless you need every market on the page. The 25 largest spot markets by 24h USD volume on one page of a coin's markets, each exactly as coin-markets lists it, with how many markets and venues the page holds and how many are flagged as outliers or stale. The same query: the coin id and the page.
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/coin-markets-brief"
| Parameter | Description |
|---|---|
coinquery · string · optional | The coin, by coin id, e.g. bitcoin, pepe, bonk. Defaults to bitcoin. |
pagequery · integer · optional | Which page of 100 markets, from 1. Defaults to 1. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
coin | string | The coin answered, by coin id, lowercase. |
page | integer | The page answered. |
marketCount | integer | Markets on the page. 0 past the last page. |
venueCount | integer | Distinct venues among them. |
anomalyCount | integer | Of them, markets flagged as an outlier. |
staleCount | integer | Of them, markets flagged as stale. |
markets | object[] | The page's first 25 markets, largest 24h USD volume first, each exactly as coin-markets lists it. |
markets[].venueId | string | null | The venue id, e.g. binance, okex; the subject of spot-venue for a centralized venue. |
markets[].venueName | string | The venue name, e.g. Binance, Raydium. |
markets[].base | string | null | The base side of the pair, e.g. PEPE; on an on-chain venue the token address (EVM lowercased). Null for a Solana token whose address is not known exactly: baseCoinId still names it. |
markets[].target | string | null | The quote side of the pair, e.g. USDT; on an on-chain venue the token address (EVM lowercased, the zero address for the native coin). Null for a Solana token whose address is not known exactly: targetCoinId still names it. |
markets[].baseCoinId | string | null | The base side, by coin id. |
markets[].targetCoinId | string | null | The quote side, by coin id. Null for a fiat quote. |
markets[].price | number | null | Last price, in the quote currency. |
markets[].priceUsd | number | null | Last price, in USD. Sub-cent prices come rounded to 3 significant figures; price is not rounded. |
markets[].volumeBase24h | number | null | 24h volume, in base-currency units. |
markets[].volumeUsd24h | number | null | 24h volume, in USD. |
markets[].spreadPercent | number | null | Bid-ask spread, in percent (0.01 = 0.01%). |
markets[].depthPlus2PercentUsd | number | null | USD of asks that must be bought to move the price 2% up. Null when not known. |
markets[].depthMinus2PercentUsd | number | null | USD of bids that must be sold into to move the price 2% down. Null when not known. |
markets[].isAnomaly | boolean | null | true when the price is flagged as an outlier against the other markets. |
markets[].isStale | boolean | null | true when the market has not traded recently. |
markets[].lastTradedAt | string | null | Last trade, ISO-8601 UTC. |
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