CoinMarketCap Cryptocurrency Listings - Data API Endpoint

Cryptocurrency Listings by api key, auxiliary fields, cryptocurrency tag, cryptocurrency type, date, limit, offset and sort.

Get bulk Cryptocurrency Listings data from the CoinMarketCap API | Official API: https://coinmarketcap.com | 👥  Contributors: steve 🚩  Report

✏️ Inputs

API Key api_key Required

Your CoinMarketCap API Key: https://pro.coinmarketcap.com/account/

Auxiliary Fields aux_fields Optional

Auxiliary Fields to return in the response. To get ALL the available fields, use:

num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply,market_cap_by_total_supply,volume_24h_reported,volume_7d,volume_7d_reported,volume_30d,volume_30d_reported,is_market_cap_included_in_calc

E.g. num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply
Cryptocurrency Tag tag Optional

Tag of crypto to include. Valid options:

  • all
  • defi
  • filesharing
E.g. all
Cryptocurrency Type cryptocurrency_type Optional

Type of crypto to return. Valid values:

  • all
  • coins
  • tokens
E.g. all
Date date Optional

Only used for the historical version of this endpoint. Provide a date in Unix or ISO 8601 format to get back the ending prices for that date.

E.g. 2021-05-06
Limit limit Optional

How many listings to return per API call. Max is 5000.

E.g. 5000
Offset offset Optional

Used for pagination, default starting position is 1.

E.g. 1
Sort sort Optional

What to sort by, default is market_cap and options are below:

  • name
  • symbol
  • date_added
  • market_cap
  • market_cap_strict
  • price
  • market_cap_by_total_supply_strict
  • volume_7d
  • volume_30d
E.g. market_cap
Sort Direction sort_dir Optional

Direction to sort, possible values are:

  • asc
  • desc
E.g. asc
Latest or Historical latest_or_historical Default latest

Whether to use the latest version of the endpoint: https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsLatest or the historical version: https://coinmarketcap.com/api/documentation/v1/#operation/getV1CryptocurrencyListingsHistorical

IMPORTANT The historical version requires you setting the date input and requires the CoinMarketCap Standard or higher pricing plan. To use this, enter historical here and make sure to set a date entry!

📝 Notes

Posted by steve on June 29, 2022, 6:31 a.m. 🚩  Report

⚡️ Endpoint

GET https://pro-api.coinmarketcap.com/v1/cryptocurrency/listings/{{latest_or_historical}}?limit={{ limit }}&start={{ offset }}&cryptocurrency_type={{ cryptocurrency_type }}&tag={{ tag }}&aux={{ aux_fields }}&sort={{ sort }}&sort_dir={{ sort_dir }}&date={{ date }}

Body

None

Headers

X-CMC_PRO_API_KEY
{{ api_key }}