---
title: "Top Gainers & Losers"
method: GET
path: "/coins/top_gainers_losers"
---

# Top Gainers & Losers

`GET /coins/top_gainers_losers`

## Request

- Base URL: `https://api.coingecko.com/api/v3`
- URL: `https://api.coingecko.com/api/v3/coins/top_gainers_losers`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To query the top 30 coins with largest price gain and loss by a specific time duration

## Query parameters

- `vs_currency` string, required
- `duration` '1h' | '24h' | '7d' | '14d' | '30d' | '60d' | '1y'
- `price_change_percentage` string
- `top_coins` '300' | '500' | '1000' | 'all'

## Response `200`

Top gainers and losers

- TopGainersLosers
  - `top_gainers` TopGainersLosersItem[], required
    - `id` string, required: Coin ID
    - `symbol` string, required: Coin symbol
    - `name` string, required: Coin name
    - `image` string, required: Coin image URL
    - `market_cap_rank` integer, nullable, required: Coin market cap rank
    - `usd` number, required: Coin price in the target currency
    - `usd_24h_vol` number, required: 24-hour trading volume in the target currency
    - `usd_24h_change` number, nullable, required: 24-hour price change percentage
    - `usd_1h_change` number, nullable: 1-hour price change percentage
    - `usd_7d_change` number, nullable: 7-day price change percentage
    - `usd_14d_change` number, nullable: 14-day price change percentage
    - `usd_30d_change` number, nullable: 30-day price change percentage
    - `usd_60d_change` number, nullable: 60-day price change percentage
    - `usd_200d_change` number, nullable: 200-day price change percentage
    - `usd_1y_change` number, nullable: 1-year price change percentage
  - `top_losers` TopGainersLosersItem[], required
    - `id` string, required: Coin ID
    - `symbol` string, required: Coin symbol
    - `name` string, required: Coin name
    - `image` string, required: Coin image URL
    - `market_cap_rank` integer, nullable, required: Coin market cap rank
    - `usd` number, required: Coin price in the target currency
    - `usd_24h_vol` number, required: 24-hour trading volume in the target currency
    - `usd_24h_change` number, nullable, required: 24-hour price change percentage
    - `usd_1h_change` number, nullable: 1-hour price change percentage
    - `usd_7d_change` number, nullable: 7-day price change percentage
    - `usd_14d_change` number, nullable: 14-day price change percentage
    - `usd_30d_change` number, nullable: 30-day price change percentage
    - `usd_60d_change` number, nullable: 60-day price change percentage
    - `usd_200d_change` number, nullable: 200-day price change percentage
    - `usd_1y_change` number, nullable: 1-year price change percentage

---

[API](https://skmtc.dev/coingecko/apis/coingecko-demo-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-demo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-demo-api/revisions/d62c9c579f3a?raw)