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

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

## Changes

- **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/0484eb6fcafa/schema)