curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/top_gainers_losers \
--header 'x-cg-pro-api-key: <api-key>'{
"top_gainers": [
{
"id": "maga-bitcoin",
"symbol": "mbtc",
"name": "MAGA Bitcoin",
"image": "https://coin-images.coingecko.com/coins/images/102172497/original/image0-removebg-preview.webp?1773518858",
"market_cap_rank": 189,
"usd": 0.17408997149936514,
"usd_24h_vol": 50396.8060000212,
"usd_24h_change": 150.5022699272054,
"usd_1h_change": -6.503819291482131,
"usd_7d_change": 519.1190967122302,
"usd_14d_change": 461.9068555244123,
"usd_30d_change": 448.72555160441027,
"usd_60d_change": 67.38949093422981,
"usd_200d_change": null,
"usd_1y_change": null
}
],
"top_losers": [
{
"id": "irys",
"symbol": "irys",
"name": "Irys",
"image": "https://coin-images.coingecko.com/coins/images/70808/original/irys.png?1764757341",
"market_cap_rank": 352,
"usd": 0.038636564524228145,
"usd_24h_vol": 77344929.5624576,
"usd_24h_change": -19.511341677152053,
"usd_1h_change": 1.6279519726091103,
"usd_7d_change": 0.8723104841951528,
"usd_14d_change": -3.0080471375482483,
"usd_30d_change": 35.11913273728426,
"usd_60d_change": 119.67467634522242,
"usd_200d_change": null,
"usd_1y_change": null
}
]
}Top Gainers & Losers
To query the top 30 coins with largest price gain and loss by a specific time duration
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/top_gainers_losers \
--header 'x-cg-pro-api-key: <api-key>'{
"top_gainers": [
{
"id": "maga-bitcoin",
"symbol": "mbtc",
"name": "MAGA Bitcoin",
"image": "https://coin-images.coingecko.com/coins/images/102172497/original/image0-removebg-preview.webp?1773518858",
"market_cap_rank": 189,
"usd": 0.17408997149936514,
"usd_24h_vol": 50396.8060000212,
"usd_24h_change": 150.5022699272054,
"usd_1h_change": -6.503819291482131,
"usd_7d_change": 519.1190967122302,
"usd_14d_change": 461.9068555244123,
"usd_30d_change": 448.72555160441027,
"usd_60d_change": 67.38949093422981,
"usd_200d_change": null,
"usd_1y_change": null
}
],
"top_losers": [
{
"id": "irys",
"symbol": "irys",
"name": "Irys",
"image": "https://coin-images.coingecko.com/coins/images/70808/original/irys.png?1764757341",
"market_cap_rank": 352,
"usd": 0.038636564524228145,
"usd_24h_vol": 77344929.5624576,
"usd_24h_change": -19.511341677152053,
"usd_1h_change": 1.6279519726091103,
"usd_7d_change": 0.8723104841951528,
"usd_14d_change": -3.0080471375482483,
"usd_30d_change": 35.11913273728426,
"usd_60d_change": 119.67467634522242,
"usd_200d_change": null,
"usd_1y_change": null
}
]
}- Only includes coins with a 24-hour trading volume of at least $50,000.
- Equivalent page on CoinGecko Gainers & Losers.
SDK Examples
const response = await client.coins.topGainersLosers.get({
vs_currency: 'usd',
});
console.log(JSON.stringify(response, null, 2));
response = client.coins.top_gainers_losers.get(
vs_currency="usd",
)
print(response.model_dump_json(indent=2))
Authorizations
Learn how to set up your API key
Query Parameters
Target currency of coins.
*refers to /simple/supported_vs_currencies
Filter result by time range.
Default: 24h
1h, 24h, 7d, 14d, 30d, 60d, 1y Include price change percentage timeframe, comma-separated if querying more than 1 timeframe.
Valid values: 1h, 24h, 7d, 14d, 30d, 60d, 200d, 1y
Filter result by market cap ranking (top 300 to 1000) or all coins (including coins that do not have market cap).
Default: 1000
300, 500, 1000, all Response
Top gainers and losers
Hide child attributes
Hide child attributes
Coin ID
Coin symbol
Coin name
Coin image URL
Coin market cap rank
Coin price in the target currency
24-hour trading volume in the target currency
24-hour price change percentage
1-hour price change percentage
7-day price change percentage
14-day price change percentage
30-day price change percentage
60-day price change percentage
200-day price change percentage
1-year price change percentage
Hide child attributes
Hide child attributes
Coin ID
Coin symbol
Coin name
Coin image URL
Coin market cap rank
Coin price in the target currency
24-hour trading volume in the target currency
24-hour price change percentage
1-hour price change percentage
7-day price change percentage
14-day price change percentage
30-day price change percentage
60-day price change percentage
200-day price change percentage
1-year price change percentage
Was this page helpful?