Frequently Asked Questions

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

General FAQ

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 optional subscription plan while using the CMC 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: Do you have a free version of the CoinMarketCap API?

A:CoinMarketCap is committed to always providing the crypto community with a robust free API through our free Basic tier. Even on free Basic our users can benefits from enterprise grade infrastructure, documentation, and flexibility. If your needs outgrow our free offering check out our commercial use and enterprise offerings.

Data FAQ

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

A:The API surfaces all current and historical cryptocurrency and exchange data available on coinmarketcap.com since it originally went live in 2013. See the general CoinMarketCap FAQ for listing criteria and considerations.

Q: How frequently do the market data endpoints update?

A:Most endpoints update every 1 minute. 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 cryptocurrency 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. These are outlined as soft caps and hard caps where soft caps give you some wiggle room before you may be rate limited. This limit resets at midnight UTC at the beginning of each calendar day and month.

As the API offers enterprise level pagination this usage is tracked as one "call credit" per 100 data points returned unless otherwise specified in endpoint documentation. 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 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 proxying your requests through your own backend script.

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

A: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. You may see this notice when market data for an exchange is in our system but not yet available over the API. There are only a handful left to confirm and this notice may all but disappear over the upcoming weeks. In the meantime a -1 response means the exchange's data is not yet available over API.

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 a question, issue, or feature request that isn't covered in the API Documentation or this FAQ. Where should I direct it?

A:We'd love to get your question answered and added to the 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.