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 and the Public API are separate RESTful JSON API services offered by CoinMarketCap. The Public API is a limited set of 4 endpoints provided as a free service for personal and academic use, and will be deprecated in December. The Professional API is a robust suite of market data endpoints designed to deliver enterprise-grade performance, flexibility, and reliability for commercial customers.

Here is a comparison matrix:

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 based on pricing tier
Rate limit10 requests per minuteEnterprise grade, based on pricing tier
Currency conversions5 cryptocurrencies
36 fiat currencies
Limit 1 per request
Any cryptocurrency
36 fiat currencies
Limit 32 per request
SupportNot availablePremium support available based on pricing 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 requiredRequired, limited free plan will be available
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 subscription plan, manage billing, view your daily and monthly usage, audit your API request logs, and manage account level configuration like notifications.

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 a higher rate limit, access to more historical data, a custom license to do something outside of our standard license agreements, integration assistant, 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 one of the paid plans for awhile before purchase?

A:We have a testing sandbox available at sandbox.coinmarketcap.com where you can create a new testing account 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 do API Call Credits work?

A:Most plans have an upper limit or "hard cap" to the number of data calls that can be made monthly. This limit is tied to your API Key's usage tier and resets at midnight UTC at the beginning of each calendar month.

An API Key's monthly usage limit is tracked as API "call credits" which are incremented 1:1 against successful (HTTP Status 200) data calls or 1 credit per 100 data points for list based calls. A detailed description of the API Call Credit system can be found in the API documentation. Enterprise plans with no credit limits are available.

Q: How do Rate Limits work?

A: Outside of expanded monthly call credits each higher subscription tier also offers higher API rate limits. API rate limits are the number of HTTP requests that can be made with an API Key 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.