Sign in
Coins

Coins List with Market Data

This endpoint allows you to query all the supported coins with price, market cap, volume and market related data

get/coins/markets

Query parameters

vs_currencystring required
Example:usd

target currency of coins and market data <br> *refers to /simple/supported_vs_currencies.

idsstring

coins' IDs, comma-separated if querying more than 1 coin. <br> *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 <br> Default top returns top-ranked tokens (by market cap or volume)

categorystring
Example:layer-1

filter based on coins' category <br> *refers to /coins/categories/list.

order'market_cap_asc' | 'market_cap_desc' | 'volume_asc' | 'volume_desc' | 'id_asc' | 'id_desc'

sort result by field, default: market_cap_desc

per_pagenumber

total results per page, default: 100 <br> Valid values: 1...250

pagenumber

page through results, default: 1

sparklineboolean

include sparkline 7 days data, default: false

price_change_percentagestring

include price change percentage timeframe, comma-separated if query more than 1 price change percentage timeframe <br> 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 place for currency price value

Response

List all coins with market data

idstring

coin ID

symbolstring

coin symbol

namestring

coin name

imagestring

coin image url

current_pricenumber

coin current price in currency

market_capnumber

coin market cap in currency

market_cap_ranknumber

coin rank by market cap

fully_diluted_valuationnumber

coin fully diluted valuation (fdv) in currency

total_volumenumber

coin total trading volume in currency

high_24hnumber

coin 24hr price high in currency

low_24hnumber

coin 24hr price low in currency

price_change_24hnumber

coin 24hr price change in currency

price_change_percentage_24hnumber

coin 24hr price change in percentage

market_cap_change_24hnumber

coin 24hr market cap change in currency

market_cap_change_percentage_24hnumber

coin 24hr market cap change in percentage

circulating_supplynumber

coin circulating supply

total_supplynumber

coin total supply

max_supplynumber

coin max supply

athnumber

coin all time high (ATH) in currency

ath_change_percentagenumber

coin all time high (ATH) change in percentage

ath_datestring date-time

coin all time high (ATH) date

atlnumber

coin all time low (atl) in currency

atl_change_percentagenumber

coin all time low (atl) change in percentage

atl_datestring date-time

coin all time low (atl) date

roistring
last_updatedstring date-time

coin last updated timestamp

Changes