Discovery and markets API
Which coins gained and lost the most across the whole market?
Top 30 gainers and top 30 losers by USD price change over 1h to 1y, among the top 300 or 1000 coins by market cap or all coins. No chain: the whole market.
/api/external/discovery/market-moversWhat it returns
The coins whose USD price rose most and fell most over a trailing window (1h to 1y), across every chain and venue, among the top 300 or 1000 coins by market cap or among all coins. Gainers come largest change first, losers most negative first, up to 30 each. The ranking is refreshed every few minutes, so a figure can trail a live price by that much — use it to find the movers, not as a price feed. volumeUsd24h is always the trailing 24h volume, whatever the window.
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/market-movers"
| Parameter | Description |
|---|---|
windowquery · string · optional | Trailing window the price change is measured over. Defaults to 24h.1h24h7d14d30d60d1y |
universequery · string · optional | Which coins compete: the top 300 or top 1000 by market cap, or all (including unranked, thinly traded coins, where the extreme moves are). Defaults to top1000.top300top1000all |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
window | string | The window answered. |
universe | string | The universe answered. |
gainers | object[] | Largest change first. |
gainers[].id | string | The coin's id, e.g. harmony. |
gainers[].symbol | string | null | Ticker as the coin lists it (often lowercase). |
gainers[].name | string | null | Display name. |
gainers[].marketCapRank | integer | null | Rank by market cap. Null for an unranked coin, which only the all universe includes. |
gainers[].priceUsd | number | null | USD price when the list was computed. |
gainers[].volumeUsd24h | number | null | Trailing 24h trading volume in USD, whatever the window. |
gainers[].changePercent | number | USD price change over the window, in percent (12.5 = +12.5 %). |
losers | object[] | Most negative change first. |
losers[].id | string | The coin's id, e.g. harmony. |
losers[].symbol | string | null | Ticker as the coin lists it (often lowercase). |
losers[].name | string | null | Display name. |
losers[].marketCapRank | integer | null | Rank by market cap. Null for an unranked coin, which only the all universe includes. |
losers[].priceUsd | number | null | USD price when the list was computed. |
losers[].volumeUsd24h | number | null | Trailing 24h trading volume in USD, whatever the window. |
losers[].changePercent | number | USD price change over the window, in percent (12.5 = +12.5 %). |
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