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": "bonk",
      "symbol": "bonk",
      "name": "Bonk",
      "image": "https://assets.coingecko.com/coins/images/28600/original/bonk.jpg?1696527587",
      "market_cap_rank": 75,
      "usd": 0.000024645873833743,
      "usd_24h_vol": 105344205.633894,
      "usd_1y_change": 4244.15510979623
    },
    {
      "id": "0x0-ai-ai-smart-contract",
      "symbol": "0x0",
      "name": "0x0.ai: AI Smart Contract",
      "image": "https://assets.coingecko.com/coins/images/28880/original/0x0.png?1696527857",
      "market_cap_rank": 235,
      "usd": 0.388236182838391,
      "usd_24h_vol": 1608196.56989005,
      "usd_1y_change": 3688.24996780839
    }
  ]
}

​
Note

  • The endpoint response only includes coins with a 24-hour trading volume of at least $50,000.
  • CoinGecko equivalent page: https://www.coingecko.com/en/crypto-gainers-losers.
  • Cache/Update Frequency: Every 5 minutes.
  • Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).

Authorizations

​
x-cg-pro-api-key
string
header
required

Query Parameters

​
vs_currency
string
default:usd
required

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

Example:

"usd"

​
duration
enum<string>

filter result by time range Default value: 24h

Available options:
1h,
24h,
7d,
14d,
30d,
60d,
1y
​
price_change_percentage
string

include price change percentage timeframe, comma-separated if query more than 1 price change percentage timeframe Valid values: 1h, 24h, 7d, 14d, 30d, 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 value: 1000

Available options:
300,
500,
1000,
all

Response

200 - application/json

List top 30 gainers and losers

​
id
string

coin ID

​
symbol
string

coin symbol

​
name
string

coin name

​
image
string

coin image url

​
market_cap_rank
number

coin rank by market cap

​
usd
number

coin price in USD

​
usd_24h_vol
number

coin 24hr volume in USD

​
usd_1y_change
number

coin 1 year change in USD