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

# Top Gainers & Losers

`GET /coins/top_gainers_losers`

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.net/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.net/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/006c13c1a566/schema)