Frequently Asked Questions

This Professional API specific FAQ outlines answers to common questions about the Professional API product. For questions around CoinMarketCap's general data gathering and reporting conventions, please check out the general CoinMarketCap FAQ.

General FAQ

Q: What's the difference between the Professional API and the Public API?

A:The Professional API is a robust suite of market data endpoints designed to deliver enterprise-grade performance, flexibility, and reliability for all crypto use cases from personal, academic, to commercial. The Public API is our legacy RESTful JSON API which will officially be migrated into the Professional API's free Basic tier in December, 2018.

We encourage all Public API users to upgrade to the free Basic tier of the Professional API at their earliest convenience.

FeaturePublic APIProfessional API
LicensePersonal use
Academic use
Personal use
Academic use
Commercial use
Live market data updatesEvery 5 minutesEvery 1 minute
Available endpoint dataCryptocurrency: List current marketcap rankings
Cryptocurrency: Get current CMC ticker data
Cryptocurrency: List all active cryptocurrencies
Global: Get current global market stats
Cryptocurrency: List current marketcap rankings
Cryptocurrency: Get current CMC ticker data
Cryptocurrency: Get historical CMC ticker data
Cryptocurrency: Get historical OHLCV data
Cryptocurrency: Get all current market pairs
Cryptocurrency: List all active cryptocurrencies
Cryptocurrency: List all inactive cryptocurrencies
Cryptocurrency: Get detailed metadata including logo assets
Exchange: List current marketcap rankings
Exchange: Get current CMC ticker data
Exchange: Get historical CMC ticker data
Exchange: Get current market pairs
Exchange: Get detailed metadata including logo assets
Exchange: List all active exchanges
Exchange: List all inactive exchanges
Global: Get current global market stats
Global: Get historical global market stats
Tools: Get currency price conversions
Historical data accessNot availableAvailable, unrestricted historical access is available by tier
Rate limit30 requests per minuteUp to 90+ requests per minute based on tier
Currency conversions5 cryptocurrencies
36 fiat currencies
Limit 1 per request
Any cryptocurrency
36 fiat currencies
Limit 32 per request
SupportNot availableAvailable and upgradeable by tier
Other noteworthy featuresNoneDeveloper Portal with usage analytics and alerts
Cloud optimized for performance and reliability at any scale
Enterprise devOps status monitoring dashboard
Enterprise SLA available
Enterprise documentation
API request bundling endpoints
High pagination limits on endpoints
Advanced sort and filtering options on endpoints
Flexible timeseries interval options on endpoints
Subscription / API KeyNot requiredSubscription not required, API Key Required
Free optionYesYes (see Basic plan)
Q: What can I expect from the Developer Portal?

A:This CMC Developer portal is the central account management portal for your API Key and subscription plan while using the Professional API. Outside of viewing the API Documentation and FAQ, you can self-provision your API Key, change and upgrade your plan, manage billing, view your daily and monthly usage, audit your API request logs, and manage account level configuration like notifications.

Q: Are you getting rid of your free API?

A:CoinMarketCap is commited to always providing the crypto community with a robust free API. That API now falls under the free Basic tier of our enterprise grade Professional API. It now benefits from enterprise grade infrastructure, documentation, and flexiblity, with a path forward for those who need to upgrade.

Data FAQ

Q: What cryptocurrencies and exchanges are available with the Professional API?

A:The Professional API surfaces all current and historical cryptocurrency and exchange data available on coinmarketcap.com. See the general CoinMarketCap FAQ for listing criteria and considerations.

Q: How frequently do the market data endpoints update?

A:Our most in-demand endpoints update every 1 minute. Other endpoints update every 5 minutes and will be migrated to 1 minute updates shortly. The update frequency for each endpoint is outlined in the endpoint's description in our API Documentation.

Q: How far back does your historical cryptocurrency and exchange data go?

A:Our historical crytocurrency data goes back to 2013.

You can list all active and inactive cryptocurrencies using our cryptocurrency map endpoint. You can list all active and inactive exchanges using our exchange map endpoint. Each cryptocurrency and exchange returned from these endpoints include a "first_historical_data" timestamp letting you know how far our historical records go back.

Q: Are cryptocurrency and exchange logo image assets available via API?

A:Yes, our /cryptocurrency/info and /exchange/info metadata endpoints include hosted logo assets in PNG format. 64px is the default size returned but you may replace "64x64" in the image path with these alternative sizes: 16, 32, 64, 128, 200.

Pricing Plans

Q: When should I consider an Enterprise plan?

A:You should consider an enterprise plan if you need higher API call credit and rate limits, access to more historical data, a custom license outside of our standard commercial agreement and/or a Service Level Agreement.

Q: How can I tell if a pricing tier has the data I need?

A:You can check the expanded feature matrix on the API Plan Feature Comparison page. The API documentation also outlines what plans support what API endpoints, just look under the description field for any particular endpoint. If you're still unsure, feel free to reach out to us at api@coinmarketcap.com.

Q: Can I trial / demo a paid plan before purchase?

A:We have a testing sandbox available at sandbox.coinmarketcap.com where you can create test accounts to trial any of our subscription tiers with real data. The data available in this sandbox is limited but convenient enough for most testing purposes. Feel free to sign up for an account and test, then switch over to pro.coinmarketcap.com when ready.

Q: How does the API Call Credits system work?

A:Each of our standard usage tiers has a set number of API calls that can be made daily and monthly. This limit resets at midnight UTC at the beginning of each calendar day and month.

As the Professional API offers enterprise level pagination this usage is tracked as one "call credit" per 100 data points returned. A more detailed outline of this system can be found in our API documentation. Enterprise plans with no credit limits are available.

Q: How do Rate Limits work?

A: Outside of larger monthly call credits each higher subscription tier also offers expanded concurrent HTTP call rate limits. This is the number of HTTP requests that can be made simultaneously or within the same minute before receiving an HTTP 429 "Too Many Requests" API throttling error. This limit resets every 60 seconds.

API Errors & Warnings

Q: Why did I receive a Access-Control-Allow-Origin error while trying to use the API?

A:This CORS error means you are trying to make HTTP requests directly to the Professional API from Javascript in the client-side of your application which is not supported. This restriction is to protect your API Key as anyone viewing your application could open their browser's Developer Tools to view your HTTP requests and steal your API Key. You should prevent your API Key from being visible on your client-side by proxing your requests through your own backend script.

Q: Why did I get a notice about redacted market details on an exchange endpoint?

A:You may see this notice when market details about an exchange are in our system but are not yet available over the API. As a premier data authority for exchange market data, we are actively working with every exchange to ensure their data is not only available to us, but also available to you over the new API service. New exchanges are being confirmed for this API service rapidly and this notice may all but disappear in the upcoming days and weeks.

Feature Requests & Support

Q: How quickly can I expect responses to support requests?

A:Customers on paid plans can expect to receive answers within 24 hours.

Q: When will your new planned features be released? Will I automatically benefit?

A:Most of our new features will be rolling out by the end of the year. Customers who are on the appropriate plans will automatically gain access to these new features.

Q: I have an question, issue, or feature request that isn't covered in the API Documenation or this FAQ. Where should I direct it?

A:We'd love to get your question answered and added to the Professional API Documentation or this FAQ. You can reach out to us at api@coinmarketcap.com and we'll get back to you as soon as we can.