COcoingecko

Coins List with Market Data

Changed on

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

get/coins/markets

Request

  • Base URL
    https://pro-api.coingecko.com/api/v3
  • Auth
    • API key in header x-cg-pro-api-key
    • or API key in query parameter x_cg_pro_api_key

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

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

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

Changes

  • 11cc9e00fd86Revision changes
    • breaking

      for the query request parameter category, default value layer-1 was removed

    • breaking

      for the query request parameter include_rehypothecated, default value false was removed

    • breaking

      for the query request parameter price_change_percentage, default value 1h was removed

    • breaking

      for the query request parameter page, the type changed from number to integer

    • breaking

      for the query request parameter per_page, the type changed from number to integer

    • info

      api tag Coins removed

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      removed from the / response property allOf list for the response status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

  • fb6b6a203ce6Revision changes
    • breaking

      the response property ////// became optional for the status

    • breaking

      the response property ////// became optional for the status

    • breaking

      the response property ////// became optional for the status