Top Gainers & Losers

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
    }
  ]
}

GET

coins

top_gainers_losers

Top Gainers & Losers

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

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Query Parameters

vs_currency

string

default:usd

required

Target currency of coins. *refers to /simple/supported_vs_currencies

duration

enum<string>

Filter result by time range. Default: 24h

Available options:

1h,

24h,

7d,

14d,

30d,

60d,

1y

price_change_percentage

string

Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 60d, 200d, 1y

top_coins

enum<string>

Filter result by market cap ranking (top 300 to 1000) or all coins (including coins that do not have market cap). Default: 1000

Available options:

300,

500,

1000,

all

Response

200 - application/json

Top gainers and losers

top_gainers

object[]

required

Show child attributes

top_losers

object[]

required

Show child attributes

💼 Recently Added Coins 💼 Coin Supply Breakdown by ID

​SDK Examples

Authorizations

Query Parameters

Response

SDK Examples