---
title: "Changes to Coins List with Market Data"
method: GET
path: "/coins/markets"
---

# Changes to Coins List with Market Data

`GET /coins/markets`

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

## Timeline

Changed in 6 of 29 revisions.

- **2026-05-28** `11cc9e00fd86`: 5 breaking, 39 info
- **2026-04-30** `fb6b6a203ce6`: 3 breaking
- **2026-02-25** `e88de4e81cdb`: 2 info
- **2025-09-22** `91c83447321b`: 5 breaking
- **2025-07-08** `4f8e578c640a`: 1 breaking, 26 warning
- **2025-05-26** `0484eb6fcafa`: 2 warning

## Changes

- **2026-05-28** `11cc9e00fd86`: 5 breaking, 39 info
  - for the `query` request parameter `category`, default value `layer-1` was removed
  - for the `query` request parameter `include_rehypothecated`, default value `false` was removed
  - for the `query` request parameter `price_change_percentage`, default value `1h` was removed
  - for the `query` request parameter `page`, the type changed from `number` to `integer`
  - for the `query` request parameter `per_page`, the type changed from `number` to `integer`
  - api tag `Coins` removed
  - added the optional property `items/price_change_percentage_14d_in_currency` to the response with the `200` status
  - added the optional property `items/price_change_percentage_1h_in_currency` to the response with the `200` status
  - added the optional property `items/price_change_percentage_1y_in_currency` to the response with the `200` status
  - added the optional property `items/price_change_percentage_200d_in_currency` to the response with the `200` status
  - added the optional property `items/price_change_percentage_24h_in_currency` to the response with the `200` status
  - added the optional property `items/price_change_percentage_30d_in_currency` to the response with the `200` status
  - added the optional property `items/price_change_percentage_7d_in_currency` to the response with the `200` status
  - added the optional property `items/roi/currency` to the response with the `200` status
  - added the optional property `items/roi/percentage` to the response with the `200` status
  - added the optional property `items/roi/times` to the response with the `200` status
  - added the optional property `items/sparkline_in_7d` to the response with the `200` status
  - removed `#/components/schemas/RoiData` from the `items/roi` response property `allOf` list for the response status `200`
  - the response property `items/ath` became required for the status `200`
  - the response property `items/ath_change_percentage` became required for the status `200`
  - the response property `items/ath_date` became required for the status `200`
  - the response property `items/atl` became required for the status `200`
  - the response property `items/atl_change_percentage` became required for the status `200`
  - the response property `items/atl_date` became required for the status `200`
  - the response property `items/circulating_supply` became required for the status `200`
  - the response property `items/current_price` became required for the status `200`
  - the response property `items/fully_diluted_valuation` became required for the status `200`
  - the response property `items/high_24h` became required for the status `200`
  - the response property `items/id` became required for the status `200`
  - the response property `items/image` became required for the status `200`
  - the response property `items/last_updated` became required for the status `200`
  - the response property `items/low_24h` became required for the status `200`
  - the response property `items/market_cap` became required for the status `200`
  - the response property `items/market_cap_change_24h` became required for the status `200`
  - the response property `items/market_cap_change_percentage_24h` became required for the status `200`
  - the response property `items/market_cap_rank` became required for the status `200`
  - the response property `items/max_supply` became required for the status `200`
  - the response property `items/name` became required for the status `200`
  - the response property `items/price_change_24h` became required for the status `200`
  - the response property `items/price_change_percentage_24h` became required for the status `200`
  - …4 more
- **2026-04-30** `fb6b6a203ce6`: 3 breaking
  - the response property `items/roi/allOf[#/components/schemas/RoiData]/currency` became optional for the status `200`
  - the response property `items/roi/allOf[#/components/schemas/RoiData]/percentage` became optional for the status `200`
  - the response property `items/roi/allOf[#/components/schemas/RoiData]/times` became optional for the status `200`
- **2026-02-25** `e88de4e81cdb`: 2 info
  - added the new optional `query` request parameter `include_rehypothecated`
  - added the optional property `items/market_cap_rank_with_rehypothecated` to the response with the `200` status
- **2025-09-22** `91c83447321b`: 5 breaking
  - for the `query` request parameter `category`, default value `layer-1` was added
  - for the `query` request parameter `ids`, default value `bitcoin` was added
  - for the `query` request parameter `names`, default value `Bitcoin` was added
  - for the `query` request parameter `price_change_percentage`, default value `1h` was added
  - for the `query` request parameter `symbols`, default value `btc` was added
- **2025-07-08** `4f8e578c640a`: 1 breaking, 26 warning
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `ath` from the response with the `200` status
  - removed the optional property `ath_change_percentage` from the response with the `200` status
  - removed the optional property `ath_date` from the response with the `200` status
  - removed the optional property `atl` from the response with the `200` status
  - removed the optional property `atl_change_percentage` from the response with the `200` status
  - removed the optional property `atl_date` from the response with the `200` status
  - removed the optional property `circulating_supply` from the response with the `200` status
  - removed the optional property `current_price` from the response with the `200` status
  - removed the optional property `fully_diluted_valuation` from the response with the `200` status
  - removed the optional property `high_24h` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `image` from the response with the `200` status
  - removed the optional property `last_updated` from the response with the `200` status
  - removed the optional property `low_24h` from the response with the `200` status
  - removed the optional property `market_cap` from the response with the `200` status
  - removed the optional property `market_cap_change_24h` from the response with the `200` status
  - removed the optional property `market_cap_change_percentage_24h` from the response with the `200` status
  - removed the optional property `market_cap_rank` from the response with the `200` status
  - removed the optional property `max_supply` from the response with the `200` status
  - removed the optional property `name` from the response with the `200` status
  - removed the optional property `price_change_24h` from the response with the `200` status
  - removed the optional property `price_change_percentage_24h` from the response with the `200` status
  - removed the optional property `roi` from the response with the `200` status
  - removed the optional property `symbol` from the response with the `200` status
  - removed the optional property `total_supply` from the response with the `200` status
  - removed the optional property `total_volume` from the response with the `200` status
- **2025-05-26** `0484eb6fcafa`: 2 warning
  - removed the optional property `price_change_percentage_1h` from the response with the `200` status
  - removed the optional property `sparkline_in_7d` from the response with the `200` status

---

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