Changelog

Version history

The CoinMarketCap API utilizes Semantic Versioning in the format major.minor.patch. The current major version is incorporated into the API request path as /v1/. Non-breaking minor and patch updates to the API are released regularly. These may include new endpoints, data points, and API plan features which are always introduced in a non-breaking manner. This means you can expect new properties to become available in our existing /v1/ endpoints however any breaking change will be introduced under a new major version of the API with legacy versions supported indefinitely unless otherwise stated.

You can subscribe to our API Newsletter to get monthly email updates on CoinMarketCap API enhancements.

v2.0.10 on Oct 14, 2024

/v3/fear-and-greed/latest and /v3/fear-and-greed/historical now available to get CMC Fear and Greed Index

v2.0.9 on June 1, 2023

/v1/community/trending/topic now available to get community trending topics.
/v1/community/trending/token now available to get community trending tokens.

v2.0.8 on November 25, 2022

/v1/exchange/assets now available to get exchange assets in the form of token holdings.

v2.0.7 on September 19, 2022

/v1/content/posts/top now available to get cryptocurrency-related top posts.
/v1/content/posts/latest now available to get cryptocurrency-related latest posts.
/v1/content/posts/comments now available to get comments of the post.

v2.0.6 on Augest 18, 2022

/v1/content/latest now available to get news/headlines and Alexandria articles.

v2.0.5 on Augest 4, 2022

/v1/tools/postman now API postman collection is available.

v2.0.4 on October 11, 2021

/v1/cryptocurrency/listings/latest now includes volume_change_24h.
/v2/cryptocurrency/quotes/latest now includes volume_change_24h.

v2.0.3 on October 6, 2021

/v1/cryptocurrency/trending/latest now supports time_period as an optional parameter.

v2.0.2 on September 13, 2021

/exchange/map now available to Free tier users.
/exchange/info now available to Free tier users.

v2.0.1 on September 8, 2021

/exchange/market-pairs/latest now includes volume_24h, depth_negative_two, depth_positive_two and volume_percentage.
/exchange/listings/latest now includes open_interest.

v2.0.0 on August 17, 2021

By popular request we have added a number of new useful endpoints !
/v1/cryptocurrency/categories can be used to access a list of categories and their associated coins. You can also filter the list of categories by one or more cryptocurrencies.
/v1/cryptocurrency/category can be used to load only a single category of coins, listing the coins within that category.
/v1/cryptocurrency/airdrops can be used to access a list of CoinMarketCap's free airdrops. This defaults to a status of ONGOING but can be filtered to UPCOMING or ENDED. You can also query for a list of airdrops by cryptocurrency.
/v1/cryptocurrency/airdrop can be used to load a single airdrop and its associated cryptocurrency.
/v1/cryptocurrency/trending/latest can be used to load the most searched for cryptocurrencies within a period of time. This defaults to a time_period of the previous 24h, but can be changed to 30d, or 7d for a larger window of time.
/v1/cryptocurrency/trending/most-visited can be used to load the most visited cryptocurrencies within a period of time. This defaults to a time_period of the previous 24h, but can be changed to 30d, or 7d for a larger window of time.
/v1/cryptocurrency/trending/gainers-losers can be used to load the biggest gainers & losers within a period of time. This defaults to a time_period of the previous 24h, but can be changed to 30d, or 7d for a larger window of time.

v1.28.0 on August 9, 2021

/v1/cryptocurrency/listings/latest now includes market_cap_dominance and fully_diluted_market_cap.
/v1/cryptocurrency/quotes/latest now includes market_cap_dominance and fully_diluted_market_cap.

v1.27.0 on January 27, 2021

/v2/cryptocurrency/info response format changed to allow for multiple coins per symbol.
/v2/cryptocurrency/market-pairs/latest response format changed to allow for multiple coins per symbol.
/v2/cryptocurrency/quotes/historical response format changed to allow for multiple coins per symbol.
/v2/cryptocurrency/ohlcv/historical response format changed to allow for multiple coins per symbol.
/v2/tools/price-conversion response format changed to allow for multiple coins per symbol.
/v2/cryptocurrency/ohlcv/latest response format changed to allow for multiple coins per symbol.
/v2/cryptocurrency/price-performance-stats/latest response format changed to allow for multiple coins per symbol.

v1.26.0 on January 21, 2021

/v2/cryptocurrency/quotes/latest response format changed to allow for multiple coins per symbol.

v1.25.0 on April 17, 2020

/v1.1/cryptocurrency/listings/latest now includes a more robust tags response with slug, name, and category.
/cryptocurrency/quotes/historical and /cryptocurrency/quotes/latest now include is_active and is_fiat in the response.

v1.24.0 on Feb 24, 2020

/cryptocurrency/ohlcv/historical has been modified to include the high and low timestamps.
/exchange/market-pairs/latest now includes category and fee_type market pair filtering options.
/cryptocurrency/listings/latest now includes category and fee_type market pair filtering options.

v1.23.0 on Feb 3, 2020

/fiat/map is now available to fetch the latest mapping of supported fiat currencies to CMC IDs.
/exchange/market-pairs/latest now includes matched_id and matched_symbol market pair filtering options.
/cryptocurrency/listings/latest now provides filter parameters price_min, price_max, market_cap_min, market_cap_max, percent_change_24h_min, percent_change_24h_max, volume_24h_max, circulating_supply_min and circulating_supply_max in addition to the existing volume_24h_min filter.

v1.22.0 on Oct 16, 2019

/global-metrics/quotes/latest now additionally returns total_cryptocurrencies and total_exchanges counts which include inactive projects who's data is still available via API.

v1.21.0 on Oct 1, 2019

/exchange/map now includes sort options including volume_24h.
/cryptocurrency/map fix for a scenario where first_historical_data and last_historical_data may not be populated.
Additional improvements to alphanumeric sorts.

v1.20.0 on Sep 25, 2019

By popular request you may now configure API plan usage notifications and email alerts in the Developer Portal.
/cryptocurrency/map now includes sort options including cmc_rank.

v1.19.0 on Sep 19, 2019

A new /blockchain/ category of endpoints is now available with the introduction of our new /v1/blockchain/statistics/latest endpoint. This endpoint can be used to poll blockchain statistics data as seen in our Blockchain Explorer.
Additional platform error codes are now surfaced during HTTP Status Code 401, 402, 403, and 429 scenarios as documented in Errors and Rate Limits.
OHLCV endpoints using the convert option now match historical UTC open period exchange rates with greater accuracy.
/cryptocurrency/info and /exchange/info now include the optional aux parameter where listing status can be requested in the list of supplemental properties.
/cryptocurrency/listings/latest and /cryptocurrency/quotes/latest: The accuracy of percent_change_ conversions was improved when passing non-USD fiat convert options.
/cryptocurrency/ohlcv/historical and /cryptocurrency/quotes/latest now support relaxed request validation rules via the skip_invalid request parameter.
We also now return a helpful notice warning when API key usage is above 95% of daily and monthly API credit usage limits.

v1.18.0 on Aug 28, 2019

/key/info has been added as a new endpoint. It may be used programmatically monitor your key usage compared to the rate limit and daily/monthly credit limits available to your API plan as an alternative to using the Developer Portal Dashboard.
/cryptocurrency/quotes/historical and /v1/global-metrics/quotes/historical have new options to make charting tasks easier and more efficient. Use the new aux parameter to cut out response properties you don't need and include the new search_interval timestamp to normalize disparate historical records against the same interval time periods.
A 4 hour interval option 4h was added to all historical time series data endpoints.

v1.17.0 on Aug 22, 2019

/cryptocurrency/price-performance-stats/latest has been added as our 21st endpoint! It returns launch price ROI, all-time high / all-time low, and other price stats over several supported time periods.
/cryptocurrency/market-pairs/latest now has the ability to filter all active markets for a cryptocurrency to specific base/quote pairs. Want to return only BTC/USD and BTC/USDT markets? Just pass ?symbol=BTC&matched_symbol=USD,USDT or ?id=1&matched_id=2781,825.
/cryptocurrency/market-pairs/latest now features sort options including cmc_rank to reproduce the methodology based sort on pages like Bitcoin Markets.
/cryptocurrency/market-pairs/latest can now return any exchange level CMC notices affecting a market via the new notice aux parameter.
/cryptocurrency/quotes/latest will now continue to return the last updated price data for cryptocurrency that have transitioned to an inactive state instead of returning an HTTP 400 error. These active coins that have gone inactive can easily be identified as having a num_market_pairs of 0 and a stale last_updated date.
/exchange/info now includes a brief text summary for most exchanges as description.

v1.16.0 on Aug 9, 2019

We've introduced a new partners category of endpoints for convenient access to 3rd party crypto data. FlipSide Crypto's Fundamental Crypto Asset Score (FCAS) is now available as the first partner integration.
/cryptocurrency/listings/latest now provides a volume_24h_min filter parameter. It can be used when a threshold of volume is required like in our Biggest Gainers and Losers lists.
/cryptocurrency/listings/latest and /cryptocurrency/quotes/latest can now return rolling volume_7d and volume_30d via the supplemental aux parameter and sort options by these fields.
volume_24h_reported, volume_7d_reported, volume_30d_reported, and market_cap_by_total_supply are also now available through the aux parameter with an additional sort option for the latter.
/cryptocurrency/market-pairs/latest can now provide market price relative to the quote currency. Just pass price_quote to the supplemental aux parameter. This can be used to display consistent price data for a cryptocurrency across several markets no matter if it is the base or quote in each pair as seen in our Bitcoin markets price column.
When requesting a custom sort on our list based endpoints, numeric fields like percent_change_7d now conveniently return non-applicable null values last regardless of sort order.

v1.15.0 on Jul 10, 2019

/cryptocurrency/map and /v1/exchange/map now expose a 3rd listing state of untracked between active and inactive as outlined in our methodology. See endpoint documentation for additional details.
/cryptocurrency/quotes/historical, /cryptocurrency/ohlcv/historical, and /exchange/quotes/latest now support fetching multiple cryptocurrencies and exchanges in the same call.
/global-metrics/quotes/latest now updates more frequently, every minute. It aslo now includes total_volume_24h_reported, altcoin_volume_24h, altcoin_volume_24h_reported, and altcoin_market_cap.
/global-metrics/quotes/historical also includes these new dimensions along with historical active_cryptocurrencies, active_exchanges, and active_market_pairs counts.
We've also added a new aux auxiliary parameter to many endpoints which can be used to customize your request. You may request new supplemental data properties that are not returned by default or slim down your response payload by excluding default aux fields you don't need in endpoints like /cryptocurrency/listings/latest. /cryptocurrency/market-pairs/latest and /exchange/market-pairs/latest can now supply market_url, currency_name, and currency_slug for each market using this new parameter. /exchange/listings/latest can now include the exchange date_launched.

v1.14.1 on Jun 14, 2019 - DATA: Phase 1 methodology updates

Per our May 1 announcement of the Data Accountability & Transparency Alliance (DATA), a platform methodology update was published. No API changes are required but users should take note:

Exchanges that are not compliant with mandatory transparency requirements (Ability to surface live trade and order book data) will be excluded from VWAP price and volume calculations returned from our /cryptocurrency/ and /global-metrics/ endpoints going forward.
These exchanges will also return a volume_24h_adjusted value of 0 from our /exchange/ endpoints like the exclusions based on market category and fee type. Stale markets (24h or older) will also be excluded. All exchanges will continue to return exchange_reported values as reported.
We welcome you to learn more about the DATA alliance and become a partner.

v1.14.0 on Jun 3, 2019

/cryptocurrency/info now include up to 5 block explorer URLs for each cryptocurrency including our brand new Bitcoin and Ethereum Explorers.
/cryptocurrency/info now provides links to most cryptocurrency white papers and technical documentation! Just reference the technical_doc array.
/cryptocurrency/info now returns a notice property that may highlight a significant event or condition that is impacting the cryptocurrency or how it is displayed. See the endpoint property description for more details.
/exchange/info also includes a notice property. This one may highlight a condition that is impacting the availability of an exchange's market data or the use of the exchange. See the endpoint property description for more details.
/exchange/info now includes the official launch date for each exchange as date_launched.
/cryptocurrency/market-pairs/latest and /exchange/market-pairs/latest now include market category (Spot, Derivatives, or OTC) and fee_type (Percentage, No Fees, Transactional Mining, or Unknown) for every market returned.
/cryptocurrency/market-pairs/latest now supports querying by cryptocurrency slug.
/cryptocurrency/listings/latest now includes a market_cap_strict sort option to apply a strict numeric sort on this field.

v1.13.0 on May 17, 2019

You may now leverage CoinMarketCap IDs for currency quote conversions across all endpoints! Just utilize the new convert_id parameter instead of the convert parameter. Learn more about creating robust integrations with CMC IDs in our Best Practices.
We've updated requesting cryptocurrencies by slug to support legacy names from past cryptocurrency rebrands. For example, a request to /cryptocurrency/quotes/latest?slug=antshares successfully returns the cryptocurrency by current slug neo.
We've extended the brief text summary included as description in /cryptocurrency/info to now cover all cryptocurrencies!
We've added the fetch-by-slug option to /cryptocurrency/ohlcv/historical.
Premium subscription users: On your next billing period we'll conveniently switch to displaying monthly/daily credit usage relative to your monthly billing period instead of calendar month and UTC midnight. Click the ? on our updated API Key Usage panel for more details.

v1.12.1 on May 1, 2019

To celebrate CoinMarketCap's 6th anniversary we've upgraded the crypto API to make more of our data available at each tier!
Our free Basic tier may now access live price conversions via /tools/price-conversion.
Our Hobbyist tier now supports a month of historical price conversions with /tools/price-conversion using the time parameter. We've also made this plan 12% cheaper at $29/mo with a yearly subscription or $35/mo month-to-month.
Our Startup tier can now access a month of cryptocurrency OHLCV data via /cryptocurrency/ohlcv/historical along with /tools/price-conversion.
Our Standard tier has been upgraded from 1 month to now 3 months of historical market data access across all historical endpoints.
Our Enterprise, Professional, and Standard tiers now get access to a new #18th endpoint /cryptocurrency/listings/historical! Utilize this endpoint to fetch daily historical crypto rankings from the past. We've made historical ranking snapshots available all the way back to 2013!
All existing accounts and subscribers may take advantage of these updates. If you haven't signed up yet you can check out our updated plans on our feature comparison page.

v1.12.0 on Apr 28, 2019

Our API docs now supply API request examples in 7 languages for every endpoint: cURL, Node.js, Python, PHP, Java, C#, and Go.
Many customer sites format cryptocurrency data page URLs by SEO friendly names like we do here: coinmarketcap.com/currencies/binance-coin. We've made it much easier for these kinds of pages to dynamically reference data from our API. You may now request cryptocurrencies from our /cryptocurrency/info and /cryptocurrency/quotes/latest endpoints by slug as an alternative to symbol or id. As always, you can retrieve a quick list of every cryptocurrency we support and it's id, symbol, and slug via our /cryptocurrency/map endpoint.
We've increased convert limits on historical endpoints once more. You can now request historical market data in up to 3 conversion options at a time like we do internally to display line charts like this. You can now fetch market data converted into your primary cryptocurrency, fiat currency, and a parent platform cryptocurrency (Ethereum in this case) all in one call!

v1.11.0 on Mar 25, 2019

We now supply a brief text summary for each cryptocurrency in the description field of /cryptocurrency/info. The majority of top cryptocurrencies include this field with more coming in the future.
We've made convert limits on some endpoints and plans more flexible. Historical endpoints are now allowed 2 price conversion options instead of 1. Professional plan convert limit has doubled from 40 to 80. Enterprise has tripled from 40 to 120.
CoinMarketCap Market ID: We now return market_id in /market-pairs/latest endpoints. Like our cryptocurrency and exchange IDs, this ID can reliably be used to uniquely identify each market permanently as this ID never changes.
Market symbol overrides: We now supply an exchange_symbol in addition to currency_symbol for each market pair returned in our /market-pairs/latest endpoints. This allows you to reference the currency symbol provided by the exchange in case it differs from the CoinMarketCap identified symbol that the majority of markets use.

v1.10.1 on Jan 30, 2019

Our API health status dashboard is now public at http://status.coinmarketcap.com.
We now conveniently return market_cap in our /cryptocurrency/ohlcv/historical endpoint so you don't have to make a separately query when fetching historic OHLCV data.
We've improved the accuracy of percent_change_1h / 24h / 7d calculations when using the convert option with our latest cryptocurrency endpoints.
/cryptocurrency/market-pairs/latest now updates more frequently, every 1 minute.
Contract Address and parent platform metadata changes are reflected on the API much more quickly.

v1.9.0 on Jan 8, 2019

Did you know there are currently 684 active USD market pairs tracked by CoinMarketCap? You can now pass any fiat CoinMarketCap ID to the /cryptocurrency/market-pairs/latest id parameter to list all active markets across all exchanges for a given fiat currency.
We've added a new dedicated migration FAQ page for users migrating from our old Public API to the new API here. It includes a helpful tutorial link for Excel and Google Sheets users who need help migrating.
Cryptocurrency and exchange symbol and name rebrands are now reflected in the API much more quickly.

v1.8.0 on Dec 27, 2018

We now supply the contract address for all cryptocurrencies on token platforms like Ethereum! Look for token_address in the platform property of our cryptocurrency endpoints like /cryptocurrency/map and /cryptocurrency/listings/latest.
All 96 non-USD fiat conversion rates now update every 1 minute like our USD rates! This includes using the convert option for all /latest market data endpoints as well as our /tools/price-conversion endpoint.

v1.7.0 on Dec 18, 2018

We've upgraded our fiat (government) currency conversion support from our original 32 to now cover 93 fiat currencies!
We've also introduced currency conversions for four precious metals: Gold, Silver, Platinum, and Palladium!
You may pass all 97 fiat currency options to our /tools/price-conversion endpoint using either the symbol or id parameter. Using CMC id is always the most robust option. CMC IDs are now included in the full list of fiat options located here.
All historical endpoints including our price conversion endpoint with "time" parameter now support historical fiat conversions back to 2013!

v1.6.0 on Dec 4, 2018

We've rolled out another top requested feature, giving you access to platform metadata for cryptocurrencies that are tokens built on other cryptocurrencies like Ethereum. Look for the new platform property on our cryptocurrency endpoints like /cryptocurrency/listings/latest and /cryptocurrency/map.
We've also added a CMC equivalent pages section to our endpoint docs so you can easily determine which endpoints to use to reproduce functionality on the main coinmarketcap.com website.
Welcome Public API users! With the migration of our legacy Public API into the Professional API we now have 1 unified API at CMC. This API is now known as the CoinMarketCap API and can always be accessed at coinmarketcap.com/api.

v1.5.0 on Nov 28, 2018

/cryptocurrency/ohlcv/historical now supports hourly OHLCV! Use time_period="hourly" and don't forget to set the "interval" parameter to "hourly" or one of the new hourly interval options.
/tools/price-conversion now supports historical USD conversions.
We've increased the minute based rate limits for several plans. Standard plan has been upgraded from 30 to 60 calls per minute. Professional from 60 to 90. Enterprise from 90 to 120.
We now include some customer and data partner logos and testimonials on the CoinMarketCap API site. Visit pro.coinmarketcap.com to check out what our enterprise customers are saying and contact us at api@coinmarketcap.com if you'd like to get added to the list!

v1.4.0 on Nov 20, 2018

/tools/price-conversion can now provide the latest crypto-to-crypto conversions at 1 minute accuracy with extended decimal precision upwards of 8 decimal places.
/tools/price-conversion now supports historical crypto-to-crypto conversions leveraging our closest averages to the specified "time" parameter.
All of our historical data endpoints now support historical cryptocurrency conversions using the "convert" parameter. The closest reference price for each "convert" option against each historical datapoint is used for each conversion.
/global-metrics/quotes/historical now supports the "convert" parameter.

v1.3.0 on Nov 9, 2018

The latest UTC day's OHLCV record is now available sooner. 5-10 minutes after each UTC midnight.
We're now returning a new vol_24h_adjusted property on /exchange/quotes/latest and /exchange/listings/latest and a sort option for the latter so you may now list exchange rankings by CMC adjusted volume as well as exchange reported.
We are now returning a tags property with /cryptocurrency/listings/latest with our first tag mineable so you know which currencies are mineable. Additional tags will be introduced in the future.
We've increased the "convert" parameter limit from 32 to 40 for plans that support max conversion limits.

v1.2.0 on Oct 30, 2018

Our exchange listing and quotes endpoints now update much more frequently! Every 1 minute instead of every 5 minutes.
These latest exchange data endpoints also now return volume_7d / 30d and percent_change_volume_24h / 7d / 30d along with existing data.
We've updated our documentation for /exchange/market-pairs/latest to reflect that it receives updates every 1 minute, not 5, since June.

v1.1.4 on Oct 19, 2018

We've improved our tiered support inboxes by plan type to answer support requests even faster.
You may now opt-in to our API mailing list on signup. If you haven't signed up you can here.

v1.1.3 on Oct 12, 2018

We've increased the rate limit of our free Basic plan from 10 calls a minute to 30.
We've increased the rate limit of our Hobbyist plan from 15 to 30.

v1.1.2 on Oct 5, 2018

We've updated our most popular /cryptocurrency/listings/latest endpoint to cost 1 credit per 200 data points instead of 100 to give customers more flexibility.
By popular request we've introduced a new $33 personal use Hobbyist tier with access to our currency conversion calculator endpoint.
Our existing commercial use Hobbyist tier has been renamed to Startup. Our free Starter tier has been renamed to Basic.

v1.1.1 on Sept 28, 2018

We've increased our monthly credit limits for our smaller plans! Existing customers plans have also been updated.
Our free Starter plan has been upgraded from 6 to 10k monthly credits (66% increase).
Our Hobbyist plan has been upgraded from 60k to 120k monthly credits (100% increase).
Our Standard plan has been upgraded from 300 to 500k monthly credits (66% increase).

v1.1.0 on Sept 14, 2018

We've introduced our first new endpoint since rollout, active day OHLCV for Standard plan and above with /v1/cryptocurrency/ohlcv/latest

v1.0.4 on Sept 7, 2018

Subscription customers with billing renewal issues now receive an alert from our API during usage and an unpublished grace period before access is restricted.
API Documentation has been improved including an outline of credit usage cost outlined on each endpoint documentation page.

v1.0.3 on Aug 24, 2018

/v1/tools/price-conversion floating point conversion accuracy was improved.
Added ability to query for non-alphanumeric crypto symbols like $PAC
Customers may now update their billing card on file with an active Stripe subscription at pro.coinmarketcap.com/account/plan