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

# Coins List with Market Data

`GET /coins/markets`

This endpoint allows you 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` number
- `page` number
- `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'

## Response `200`

List all coins with market data

- CoinsMarketsItem[]
  - `id` string — coin ID
  - `symbol` string — coin symbol
  - `name` string — coin name
  - `image` string — coin image url
  - `current_price` number, nullable — coin current price in currency
  - `market_cap` number, nullable — coin market cap in currency
  - `market_cap_rank` number, nullable — coin rank by market cap
  - `fully_diluted_valuation` number, nullable — coin fully diluted valuation (fdv) in currency
  - `total_volume` number, nullable — coin total trading volume in currency
  - `high_24h` number, nullable — coin 24hr price high in currency
  - `low_24h` number, nullable — coin 24hr price low in currency
  - `price_change_24h` number, nullable — coin 24hr price change in currency
  - `price_change_percentage_24h` number, nullable — coin 24hr price change in percentage
  - `market_cap_change_24h` number, nullable — coin 24hr market cap change in currency
  - `market_cap_change_percentage_24h` number, nullable — coin 24hr market cap change in percentage
  - `circulating_supply` number, nullable — coin circulating supply
  - `total_supply` number, nullable — coin total supply
  - `max_supply` number, nullable — coin max supply
  - `ath` number, nullable — coin all time high (ATH) in currency
  - `ath_change_percentage` number, nullable — coin all time high (ATH) change in percentage
  - `ath_date` string, date-time, nullable — coin all time high (ATH) date
  - `atl` number, nullable — coin all time low (atl) in currency
  - `atl_change_percentage` number, nullable — coin all time low (atl) change in percentage
  - `atl_date` string, date-time, nullable — coin all time low (atl) date
  - `roi` RoiData
    - `times` number, required — ROI multiplier
    - `currency` string, required — ROI currency
    - `percentage` number, required — ROI percentage
  - `last_updated` string, date-time — coin last updated timestamp

## Changes

- **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
- **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
  - …23 more
- **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

[Change 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/a23494dedfc2/schema)