The CoinMarketCap API utilizes Semantic Versioning in the format major.minor.patch. The API request path includes a major version such as /v1/, /v2/, or /v3/. Non-breaking minor and patch updates are released regularly and may include new endpoints, data points, and API plan features. This means you can expect new properties to become available in existing endpoints, while any breaking change will be introduced under a new major version with legacy versions supported unless otherwise stated.
v3.0.1 on Mar 19, 2026
- Migrated the CoinMarketCap Pro API docs to the new documentation site with updated navigation, onboarding guides, workflow pages, and reference entry points.
v2.0.10 on Oct 14, 2024
/v3/fear-and-greed/latestand/v3/fear-and-greed/historicalnow available to get CMC Fear and Greed Index
v2.0.9 on June 1, 2023
/v1/community/trending/topicnow available to get community trending topics./v1/community/trending/tokennow available to get community trending tokens.
v2.0.8 on November 25, 2022
/v1/exchange/assetsnow available to get exchange assets in the form of token holdings.
v2.0.7 on September 19, 2022
/v1/content/posts/topnow available to get cryptocurrency-related top posts./v1/content/posts/latestnow available to get cryptocurrency-related latest posts./v1/content/posts/commentsnow available to get comments of the post.
v2.0.6 on Augest 18, 2022
/v1/content/latestnow available to get news/headlines and Alexandria articles.
v2.0.5 on Augest 4, 2022
/v1/tools/postmannow API postman collection is available.
v2.0.4 on October 11, 2021
/v1/cryptocurrency/listings/latestnow includesvolume_change_24h./v2/cryptocurrency/quotes/latestnow includesvolume_change_24h.
v2.0.3 on October 6, 2021
/v1/cryptocurrency/trending/latestnow supportstime_periodas an optional parameter.
v2.0.2 on September 13, 2021
/exchange/mapnow available to Free tier users./exchange/infonow available to Free tier users.
v2.0.1 on September 8, 2021
/exchange/market-pairs/latestnow includesvolume_24h,depth_negative_two,depth_positive_twoandvolume_percentage./exchange/listings/latestnow includesopen_interest.
v2.0.0 on August 17, 2021
- By popular request we have added a number of new useful endpoints !
/v1/cryptocurrency/categoriescan 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/categorycan be used to load only a single category of coins, listing the coins within that category./v1/cryptocurrency/airdropscan be used to access a list of CoinMarketCap's free airdrops. This defaults to a status ofONGOINGbut can be filtered toUPCOMINGorENDED. You can also query for a list of airdrops by cryptocurrency./v1/cryptocurrency/airdropcan be used to load a single airdrop and its associated cryptocurrency./v1/cryptocurrency/trending/latestcan be used to load the most searched for cryptocurrencies within a period of time. This defaults to atime_periodof the previous24h, but can be changed to30d, or7dfor a larger window of time./v1/cryptocurrency/trending/most-visitedcan be used to load the most visited cryptocurrencies within a period of time. This defaults to atime_periodof the previous24h, but can be changed to30d, or7dfor a larger window of time./v1/cryptocurrency/trending/gainers-loserscan be used to load the biggest gainers & losers within a period of time. This defaults to atime_periodof the previous24h, but can be changed to30d, or7dfor a larger window of time.
v1.28.0 on August 9, 2021
/v1/cryptocurrency/listings/latestnow includesmarket_cap_dominanceandfully_diluted_market_cap./v1/cryptocurrency/quotes/latestnow includesmarket_cap_dominanceandfully_diluted_market_cap.
v1.27.0 on January 27, 2021
/v2/cryptocurrency/inforesponse format changed to allow for multiple coins per symbol./v2/cryptocurrency/market-pairs/latestresponse format changed to allow for multiple coins per symbol./v2/cryptocurrency/quotes/historicalresponse format changed to allow for multiple coins per symbol./v2/cryptocurrency/ohlcv/historicalresponse format changed to allow for multiple coins per symbol./v2/tools/price-conversionresponse format changed to allow for multiple coins per symbol./v2/cryptocurrency/ohlcv/latestresponse format changed to allow for multiple coins per symbol./v2/cryptocurrency/price-performance-stats/latestresponse format changed to allow for multiple coins per symbol.
v1.26.0 on January 21, 2021
/v2/cryptocurrency/quotes/latestresponse format changed to allow for multiple coins per symbol.
v1.25.0 on April 17, 2020
/v1.1/cryptocurrency/listings/latestnow includes a more robusttagsresponse with slug, name, and category./cryptocurrency/quotes/historicaland/cryptocurrency/quotes/latestnow includeis_activeandis_fiatin the response.
v1.24.0 on Feb 24, 2020
/cryptocurrency/ohlcv/historicalhas been modified to include the high and low timestamps./exchange/market-pairs/latestnow includescategoryandfee_typemarket pair filtering options./cryptocurrency/listings/latestnow includescategoryandfee_typemarket pair filtering options.
v1.23.0 on Feb 3, 2020
/fiat/mapis now available to fetch the latest mapping of supported fiat currencies to CMC IDs./exchange/market-pairs/latestnow includesmatched_idandmatched_symbolmarket pair filtering options./cryptocurrency/listings/latestnow provides filter parametersprice_min,price_max,market_cap_min,market_cap_max,percent_change_24h_min,percent_change_24h_max,volume_24h_max,circulating_supply_minandcirculating_supply_maxin addition to the existingvolume_24h_minfilter.
v1.22.0 on Oct 16, 2019
/global-metrics/quotes/latestnow additionally returnstotal_cryptocurrenciesandtotal_exchangescounts which include inactive projects who's data is still available via API.
v1.21.0 on Oct 1, 2019
/exchange/mapnow includessortoptions includingvolume_24h./cryptocurrency/mapfix for a scenario wherefirst_historical_dataandlast_historical_datamay 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/mapnow includessortoptions includingcmc_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/latestendpoint. 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 Rate limits, errors, and troubleshooting.
- OHLCV endpoints using the
convertoption now match historical UTC open period exchange rates with greater accuracy. /cryptocurrency/infoand/exchange/infonow include the optionalauxparameter where listingstatuscan be requested in the list of supplemental properties./cryptocurrency/listings/latestand/cryptocurrency/quotes/latest: The accuracy ofpercent_change_conversions was improved when passing non-USD fiatconvertoptions./cryptocurrency/ohlcv/historicaland/cryptocurrency/quotes/latestnow support relaxed request validation rules via theskip_invalidrequest parameter.- We also now return a helpful
noticewarning when API key usage is above 95% of daily and monthly API credit usage limits.
v1.18.0 on Aug 28, 2019
/key/infohas 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/historicaland/v1/global-metrics/quotes/historicalhave new options to make charting tasks easier and more efficient. Use the newauxparameter to cut out response properties you don't need and include the newsearch_intervaltimestamp to normalize disparate historical records against the sameintervaltime periods.- A 4 hour interval option
4hwas added to all historical time series data endpoints.
v1.17.0 on Aug 22, 2019
/cryptocurrency/price-performance-stats/latesthas 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/latestnow has the ability to filter all active markets for a cryptocurrency to specific base/quote pairs. Want to return onlyBTC/USDandBTC/USDTmarkets? Just pass?symbol=BTC&matched_symbol=USD,USDTor?id=1&matched_id=2781,825./cryptocurrency/market-pairs/latestnow featuressortoptions includingcmc_rankto reproduce the methodology based sort on pages like Bitcoin Markets./cryptocurrency/market-pairs/latestcan now return any exchange level CMC notices affecting a market via the newnoticeauxparameter./cryptocurrency/quotes/latestwill now continue to return the last updated price data for cryptocurrency that have transitioned to aninactivestate instead of returning an HTTP 400 error. These active coins that have gone inactive can easily be identified as having anum_market_pairsof0and a stalelast_updateddate./exchange/infonow includes a brief text summary for most exchanges asdescription.
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/latestnow provides avolume_24h_minfilter parameter. It can be used when a threshold of volume is required like in our Biggest Gainers and Losers lists./cryptocurrency/listings/latestand/cryptocurrency/quotes/latestcan now return rollingvolume_7dandvolume_30dvia the supplementalauxparameter and sort options by these fields.volume_24h_reported,volume_7d_reported,volume_30d_reported, andmarket_cap_by_total_supplyare also now available through theauxparameter with an additional sort option for the latter./cryptocurrency/market-pairs/latestcan now provide market price relative to the quote currency. Just passprice_quoteto the supplementalauxparameter. 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
sorton our list based endpoints, numeric fields likepercent_change_7dnow conveniently return non-applicablenullvalues last regardless of sort order.
v1.15.0 on Jul 10, 2019
/cryptocurrency/mapand/v1/exchange/mapnow expose a 3rd listing state ofuntrackedbetweenactiveandinactiveas outlined in our methodology. See endpoint documentation for additional details./cryptocurrency/quotes/historical,/cryptocurrency/ohlcv/historical, and/exchange/quotes/latestnow support fetching multiple cryptocurrencies and exchanges in the same call./global-metrics/quotes/latestnow updates more frequently, every minute. It aslo now includestotal_volume_24h_reported,altcoin_volume_24h,altcoin_volume_24h_reported, andaltcoin_market_cap./global-metrics/quotes/historicalalso includes these new dimensions along with historicalactive_cryptocurrencies,active_exchanges, andactive_market_pairscounts.- We've also added a new
auxauxiliary 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 defaultauxfields you don't need in endpoints like/cryptocurrency/listings/latest./cryptocurrency/market-pairs/latestand/exchange/market-pairs/latestcan now supplymarket_url,currency_name, andcurrency_slugfor each market using this new parameter./exchange/listings/latestcan now include the exchangedate_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_adjustedvalue 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 returnexchange_reportedvalues as reported. - We welcome you to learn more about the DATA alliance and become a partner.
v1.14.0 on Jun 3, 2019
/cryptocurrency/infonow include up to 5 block explorer URLs for each cryptocurrency including our brand new Bitcoin and Ethereum Explorers./cryptocurrency/infonow provides links to most cryptocurrency white papers and technical documentation! Just reference thetechnical_docarray./cryptocurrency/infonow returns anoticeproperty 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/infoalso includes anoticeproperty. 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/infonow includes the official launch date for each exchange asdate_launched./cryptocurrency/market-pairs/latestand/exchange/market-pairs/latestnow include marketcategory(Spot, Derivatives, or OTC) andfee_type(Percentage, No Fees, Transactional Mining, or Unknown) for every market returned./cryptocurrency/market-pairs/latestnow supports querying by cryptocurrencyslug./cryptocurrency/listings/latestnow includes amarket_cap_strictsort 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
quoteconversions across all endpoints! Just utilize the newconvert_idparameter instead of theconvertparameter. Learn more about creating robust integrations with CMC IDs in our Best practices. - We've updated requesting cryptocurrencies by
slugto support legacy names from past cryptocurrency rebrands. For example, a request to/cryptocurrency/quotes/latest?slug=antsharessuccessfully returns the cryptocurrency by current slugneo. - We've extended the brief text summary included as
descriptionin/cryptocurrency/infoto 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-conversionusing thetimeparameter. 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/historicalalong 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/infoand/cryptocurrency/quotes/latestendpoints byslugas an alternative tosymbolorid. As always, you can retrieve a quick list of every cryptocurrency we support and it'sid,symbol, andslugvia our/cryptocurrency/mapendpoint. - We've increased
convertlimits 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
descriptionfield of/cryptocurrency/info. The majority of top cryptocurrencies include this field with more coming in the future. - We've made
convertlimits 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_idin /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_symbolin addition tocurrency_symbolfor 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_capin our/cryptocurrency/ohlcv/historicalendpoint 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
convertoption with our latest cryptocurrency endpoints. /cryptocurrency/market-pairs/latestnow 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/latestidparameter 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_addressin theplatformproperty of our cryptocurrency endpoints like/cryptocurrency/mapand/cryptocurrency/listings/latest. - All 96 non-USD fiat conversion rates now update every 1 minute like our USD rates! This includes using the
convertoption for all /latest market data endpoints as well as our/tools/price-conversionendpoint.
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-conversionendpoint using either thesymboloridparameter. Using CMCidis always the most robust option. CMC IDs are now included in the API response format, IDs, and timestamps guide. - 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
platformproperty on our cryptocurrency endpoints like/cryptocurrency/listings/latestand/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/historicalnow 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-conversionnow 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-conversioncan now provide the latest crypto-to-crypto conversions at 1 minute accuracy with extended decimal precision upwards of 8 decimal places./tools/price-conversionnow 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/historicalnow 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_adjustedproperty on/exchange/quotes/latestand/exchange/listings/latestand 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
tagsproperty with/cryptocurrency/listings/latestwith our first tagmineableso 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
listingandquotesendpoints now update much more frequently! Every 1 minute instead of every 5 minutes. - These latest exchange data endpoints also now return
volume_7d / 30dandpercent_change_volume_24h / 7d / 30dalong with existing data. - We've updated our documentation for
/exchange/market-pairs/latestto 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 create an account.
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