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

# Coins List with Market Data

`GET /coins/markets`

To query all the supported coins with price, market cap, volume and market related data

## Query parameters

- `vs_currency` string, required
- `ids` string
- `names` string
- `symbols` string
- `include_tokens` 'top' | 'all'
- `category` string
- `order` 'market_cap_asc' | 'market_cap_desc' | 'volume_asc' | 'volume_desc' | 'id_asc' | 'id_desc'
- `per_page` integer
- `page` integer
- `sparkline` boolean
- `price_change_percentage` string
- `locale` 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'nl' | 'no' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh-tw'
- `precision` 'full' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18'
- `include_rehypothecated` boolean

## Response `200`

List of coins with market data

- object[]
  - `id` string, required — Coin ID
  - `symbol` string, required — Coin symbol
  - `name` string, required — Coin name
  - `image` string, required — Coin image URL
  - `current_price` number, nullable, required — Current price in target currency
  - `market_cap` number, nullable, required — Market cap in target currency
  - `market_cap_rank` integer, nullable, required — Market cap rank
  - `fully_diluted_valuation` number, nullable, required — Fully diluted valuation in target currency
  - `total_volume` number, nullable, required — Total trading volume in target currency
  - `high_24h` number, nullable, required — 24-hour price high in target currency
  - `low_24h` number, nullable, required — 24-hour price low in target currency
  - `price_change_24h` number, nullable, required — 24-hour price change in target currency
  - `price_change_percentage_24h` number, nullable, required — 24-hour price change percentage
  - `market_cap_change_24h` number, nullable, required — 24-hour market cap change in target currency
  - `market_cap_change_percentage_24h` number, nullable, required — 24-hour market cap change percentage
  - `circulating_supply` number, nullable, required — Circulating supply
  - `total_supply` number, nullable, required — Total supply
  - `max_supply` number, nullable, required — Max supply
  - `ath` number, nullable, required — All-time high price in target currency
  - `ath_change_percentage` number, nullable, required — All-time high change percentage
  - `ath_date` string, date-time, nullable, required — All-time high date
  - `atl` number, nullable, required — All-time low price in target currency
  - `atl_change_percentage` number, nullable, required — All-time low change percentage
  - `atl_date` string, date-time, nullable, required — All-time low date
  - `roi` object, nullable, required — Return on investment data
    - `times` number — ROI multiplier
    - `currency` string — ROI currency
    - `percentage` number — ROI percentage
  - `last_updated` string, date-time, required — Last updated timestamp
  - `market_cap_rank_with_rehypothecated` integer, nullable — Market cap rank including rehypothecated tokens
  - `sparkline_in_7d` object — Sparkline price data for the last 7 days
    - `price` number[] — Array of price values
  - `price_change_percentage_1h_in_currency` number, nullable — 1-hour price change percentage in target currency
  - `price_change_percentage_24h_in_currency` number, nullable — 24-hour price change percentage in target currency
  - `price_change_percentage_7d_in_currency` number, nullable — 7-day price change percentage in target currency
  - `price_change_percentage_14d_in_currency` number, nullable — 14-day price change percentage in target currency
  - `price_change_percentage_30d_in_currency` number, nullable — 30-day price change percentage in target currency
  - `price_change_percentage_200d_in_currency` number, nullable — 200-day price change percentage in target currency
  - `price_change_percentage_1y_in_currency` number, nullable — 1-year price change percentage in target currency

## 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/format was changed from `number`/`` to `integer`/``
  - …40 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
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/coins/markets/get.md)

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/006c13c1a566/schema)