Listings Historical
Returns a ranked and sorted list of all cryptocurrencies for a historical UTC date.
Technical Notes
This endpoint is identical in format to our /cryptocurrency/listings/latest endpoint but is used to retrieve historical daily ranking snapshots from the end of each UTC day.
Daily snapshots reflect market data at the end of each UTC day and may be requested as far back as 2013-04-28 (as supported by your plan's historical limits).
The required "date" parameter can be passed as a Unix timestamp or ISO 8601 date but only the date portion of the timestamp will be referenced. It is recommended to send an ISO date format like "2019-10-10" without time.
This endpoint is for retrieving paginated and sorted lists of all currencies. If you require historical market data on specific cryptocurrencies you should use /cryptocurrency/quotes/historical.
Cryptocurrencies are listed by cmc_rank by default. You may optionally sort against any of the following:
cmc_rank: CoinMarketCap's market cap rank as outlined in our methodology.
name: The cryptocurrency name.
symbol: The cryptocurrency symbol.
market_cap: market cap (latest trade price x circulating supply).
price: latest average trade price across markets.
circulating_supply: approximate number of coins currently in circulation.
total_supply: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned).
max_supply: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency.
num_market_pairs: number of market pairs across all exchanges trading each currency.
volume_24h: 24 hour trading volume for each currency.
percent_change_1h: 1 hour trading price percentage change for each currency.
percent_change_24h: 24 hour trading price percentage change for each currency.
percent_change_7d: 7 day trading price percentage change for each currency.
This endpoint is available on the following API plans:
Basic
Hobbyist (1 month)
Startup (1 month)
Standard (3 month)
Professional (12 months)
Enterprise (Up to 6 years)
Cache / Update frequency: The last completed UTC day is available 30 minutes after midnight on the next UTC day.
Plan credit use: 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per convert option beyond the first.
CMC equivalent pages: Our historical daily crypto ranking snapshot pages like this one on February 02, 2014.
Listings Historical Returns a ranked and sorted list of all cryptocurrencies for a historical UTC date.
Technical Notes
Cryptocurrencies are listed by cmc_rank by default. You may optionally sort against any of the following: cmc_rank: CoinMarketCap's market cap rank as outlined in our methodology. name: The cryptocurrency name. symbol: The cryptocurrency symbol. market_cap: market cap (latest trade price x circulating supply). price: latest average trade price across markets. circulating_supply: approximate number of coins currently in circulation. total_supply: approximate total amount of coins in existence right now (minus any coins that have been verifiably burned). max_supply: our best approximation of the maximum amount of coins that will ever exist in the lifetime of the currency. num_market_pairs: number of market pairs across all exchanges trading each currency. volume_24h: 24 hour trading volume for each currency. percent_change_1h: 1 hour trading price percentage change for each currency. percent_change_24h: 24 hour trading price percentage change for each currency. percent_change_7d: 7 day trading price percentage change for each currency.
This endpoint is available on the following API plans:
BasicCache / Update frequency: The last completed UTC day is available 30 minutes after midnight on the next UTC day. Plan credit use: 1 call credit per 100 cryptocurrencies returned (rounded up) and 1 call credit per
convertoption beyond the first. CMC equivalent pages: Our historical daily crypto ranking snapshot pages like this one on February 02, 2014.