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

# Changes to Top Gainers & Losers

`GET /coins/top_gainers_losers`

> Every recorded change to this operation, newest first.
> 29 revisions in range; 1 not diffed.

## Timeline

Changed in 2 of 29 revisions.

- **2026-05-28** `11cc9e00fd86`: 2 breaking, 21 info
- **2025-09-22** `91c83447321b`: 1 breaking, 3 info

## Changes

- **2026-05-28** `11cc9e00fd86`: 2 breaking, 21 info
  - the response property `top_gainers/items/market_cap_rank` became nullable for the status `200`
  - the response property `top_losers/items/market_cap_rank` became nullable for the status `200`
  - api tag `Coins` removed
  - added the optional property `top_gainers/items/usd_60d_change` to the response with the `200` status
  - added the optional property `top_losers/items/usd_60d_change` to the response with the `200` status
  - the response property `top_gainers` became required for the status `200`
  - the response property `top_gainers/items/id` became required for the status `200`
  - the response property `top_gainers/items/image` became required for the status `200`
  - the response property `top_gainers/items/market_cap_rank` became required for the status `200`
  - the response property `top_gainers/items/name` became required for the status `200`
  - the response property `top_gainers/items/symbol` became required for the status `200`
  - the response property `top_gainers/items/usd` became required for the status `200`
  - the response property `top_gainers/items/usd_24h_change` became required for the status `200`
  - the response property `top_gainers/items/usd_24h_vol` became required for the status `200`
  - the response property `top_losers` became required for the status `200`
  - the response property `top_losers/items/id` became required for the status `200`
  - the response property `top_losers/items/image` became required for the status `200`
  - the response property `top_losers/items/market_cap_rank` became required for the status `200`
  - the response property `top_losers/items/name` became required for the status `200`
  - the response property `top_losers/items/symbol` became required for the status `200`
  - the response property `top_losers/items/usd` became required for the status `200`
  - the response property `top_losers/items/usd_24h_change` became required for the status `200`
  - the response property `top_losers/items/usd_24h_vol` became required for the status `200`
- **2025-09-22** `91c83447321b`: 1 breaking, 3 info
  - the response's body type changed from `array` to `object` for status `200`
  - added the new optional `query` request parameter `price_change_percentage`
  - added the optional property `top_gainers` to the response with the `200` status
  - added the optional property `top_losers` to the response with the `200` status

---

[Operation](https://skmtc.dev/coingecko/apis/coingecko-api/docs/coins/top_gainers_losers/get.md) - [API](https://skmtc.dev/coingecko/apis/coingecko-api.md) - [Page](https://skmtc.dev/coingecko/apis/coingecko-api/changes/coins/top_gainers_losers/get)