---
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

---

[API](https://skmtc.net/coingecko/apis/coingecko-demo-api.md) · [All operations](https://skmtc.net/coingecko/apis/coingecko-demo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coingecko/coingecko-demo-api/versions/d62c9c579f3a/schema)