v1

latestOpenAPI 3.0.02026-07-228772344.5 KB

Coins List with Market Data

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

get/coins/markets

Query parameters

vs_currencystring required

Target currency of coins and market data. *refers to /simple/supported_vs_currencies

idsstring

Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list

namesstring

Coins' names, comma-separated if querying more than 1 coin.

symbolsstring

Coins' symbols, comma-separated if querying more than 1 coin.

include_tokens'top' | 'all'

For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume.

categorystring

Filter based on coins' category. *refers to /coins/categories/list

Sort result by field. Default: market_cap_desc

per_pageinteger

Total results per page. Default: 100 Valid values: 1...250

pageinteger

Page through results. Default: 1

sparklineboolean

Include sparkline 7-day data. Default: false

price_change_percentagestring

Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y

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'

Language background. Default: en

precision'full' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18'

Decimal places for currency price value

include_rehypothecatedboolean

Include rehypothecated tokens in results. When true, returns market_cap_rank_with_rehypothecated field. Default: false

Response

List of coins with market data

idstring required

Coin ID

symbolstring required

Coin symbol

namestring required

Coin name

imagestring required

Coin image URL

current_pricenumber nullable required

Current price in target currency

market_capnumber nullable required

Market cap in target currency

market_cap_rankinteger nullable required

Market cap rank

fully_diluted_valuationnumber nullable required

Fully diluted valuation in target currency

total_volumenumber nullable required

Total trading volume in target currency

high_24hnumber nullable required

24-hour price high in target currency

low_24hnumber nullable required

24-hour price low in target currency

price_change_24hnumber nullable required

24-hour price change in target currency

price_change_percentage_24hnumber nullable required

24-hour price change percentage

market_cap_change_24hnumber nullable required

24-hour market cap change in target currency

market_cap_change_percentage_24hnumber nullable required

24-hour market cap change percentage

circulating_supplynumber nullable required

Circulating supply

total_supplynumber nullable required

Total supply

max_supplynumber nullable required

Max supply

athnumber nullable required

All-time high price in target currency

ath_change_percentagenumber nullable required

All-time high change percentage

ath_datestring date-time nullable required

All-time high date

atlnumber nullable required

All-time low price in target currency

atl_change_percentagenumber nullable required

All-time low change percentage

atl_datestring date-time nullable required

All-time low date

last_updatedstring date-time required

Last updated timestamp

market_cap_rank_with_rehypothecatedinteger nullable

Market cap rank including rehypothecated tokens

price_change_percentage_1h_in_currencynumber nullable

1-hour price change percentage in target currency

price_change_percentage_24h_in_currencynumber nullable

24-hour price change percentage in target currency

price_change_percentage_7d_in_currencynumber nullable

7-day price change percentage in target currency

price_change_percentage_14d_in_currencynumber nullable

14-day price change percentage in target currency

price_change_percentage_30d_in_currencynumber nullable

30-day price change percentage in target currency

price_change_percentage_200d_in_currencynumber nullable

200-day price change percentage in target currency

price_change_percentage_1y_in_currencynumber nullable

1-year price change percentage in target currency