CoinGecko Crypto Data API Plans
Recommended
|
||||||
---|---|---|---|---|---|---|
Compare Plans |
Demo (Beta)
Attribution required
|
Analyst
$129/mo
|
Lite
$499/mo
|
Pro
$999/mo
|
Enterprise
|
|
Call credits /mo
|
10K | 500K | 2M | 5M | Custom | |
Rate limit /min
|
30 | 500 | 500 | 1,000 | Custom | |
Market data endpoints
|
30 | 60+ | 60+ | 60+ | 70 | |
Token Data Access
|
10,000+ | 2M+ | 2M+ | 2M+ | 2M+ | |
Data Freshness
|
from 60 sec | from 30 sec | from 30 sec | from 30 sec | from 30 sec | |
Coin Historical Data (Daily)
|
1 year | from 2013 | from 2013 | from 2013 | from 2013 | |
Coin Historical Data (Hourly)
|
1 year | from 2018 | from 2018 | from 2018 | from 2018 | |
Coin Historical Data (5 Minutely)
|
1 day | 1 day | 1 day | 1 day | from 2018 | |
Exchange Historical Data
|
1 year | from 2018 | from 2018 | from 2018 | from 2018 | |
API Keys
|
1 | 10 | 10 | 10 | 25 | |
License
|
Commercial | Commercial | Commercial | Custom | ||
Exclusive data endpoints | ||||||
NFT Market Data (Full)
|
||||||
Historical Global Market Cap
|
||||||
Historical Circulating Supply
|
||||||
Token Lists
|
||||||
🔥 Onchain DEX Data
|
||||||
Support | ||||||
FAQ Support
|
||||||
Priority Email Support
|
||||||
Slack Chat Support
|
||||||
24x7 Support
|
||||||
Service Level Agreement (SLA)
|
99.9% | |||||
Explore Docs
|
Learn More
|
Recommended
|
||||||
---|---|---|---|---|---|---|
Compare Plans |
Demo (Beta)
Attribution required
|
Analyst
$103.2/mo
|
Lite
$399.2/mo
|
Pro
$799.2/mo
|
Enterprise
|
|
Call credits /mo
|
10K | 500K | 2M | 5M | Custom | |
Rate limit /min
|
30 | 500 | 500 | 1,000 | Custom | |
Market data endpoints
|
30 | 60+ | 60+ | 60+ | 70 | |
Token Data Access
|
10,000+ | 2M+ | 2M+ | 2M+ | 2M+ | |
Data Freshness
|
from 60 sec | from 30 sec | from 30 sec | from 30 sec | from 30 sec | |
Coin Historical Data (Daily)
|
1 year | from 2013 | from 2013 | from 2013 | from 2013 | |
Coin Historical Data (Hourly)
|
1 year | from 2018 | from 2018 | from 2018 | from 2018 | |
Coin Historical Data (5 Minutely)
|
1 day | 1 day | 1 day | 1 day | from 2018 | |
Exchange Historical Data
|
1 year | from 2018 | from 2018 | from 2018 | from 2018 | |
API Keys
|
1 | 10 | 10 | 10 | 25 | |
License
|
Commercial | Commercial | Commercial | Custom | ||
Exclusive data endpoints | ||||||
NFT Market Data (Full)
|
||||||
Historical Global Market Cap
|
||||||
Historical Circulating Supply
|
||||||
Token Lists
|
||||||
🔥 Onchain DEX Data
|
||||||
Support | ||||||
FAQ Support
|
||||||
Priority Email Support
|
||||||
Slack Chat Support
|
||||||
24x7 Support
|
||||||
Service Level Agreement (SLA)
|
99.9% | |||||
Explore Docs
|
Learn More
|
Frequently Asked Questions
- Can I try out the API? Where can I find the documentation?
-
Sure thing - you may find our API documentation here.
- Do I need API keys to access your Public API?
-
Yes, please subscribe to a paid plan above or create demo account to get your API key.
- I can’t seem to query for data XYZ despite using the name of coin XYZ as an identifier for an endpoint. Where can I get the full list of coins and identifiers?
-
Do check here or this Google Sheets for the full list of coins and their respective identifiers. With over 16,000+ different cryptocurrencies available for query, coin names may not be unique and cannot be used directly as the identifier.
- Is there a guide to get started for beginners?
-
You may check out our tutorial guidebook here!
- Can I access your data through Google Sheets directly?
-
Yes! Here is a step-by-step guide on how you can use our API on your Google Sheets.
- Can I access your data through Microsoft Excel directly?
-
Definitely! You may refer to the step-by-step guide on how you can use our API on Microsoft Excel here.
- Do you have a dedicated news section for API users to keep up with changes and updates?
-
Sure thing - follow us here on our API Newsletter! We’ll only send API related news and nothing else.
- Where can I read CoinGecko API Terms of Service?
-
You can find our Terms of Service here.
- What is the changelog for this API?
-
You can find the API changelog here.
- What are the differences between commercial and custom licenses?
-
Commercial use for Analyst, Lite and Pro plan:
- Your product shall prominently display the message 'Data provided by CoinGecko' and include a hyperlink to https://www.coingecko.com/en/api. Learn more about our branding guide here here
- You're entitled to charge for your services and products that incorporate or integrate data from CoinGecko API. However, you are not permitted to sell, rent, lease, sub-license, re-distribute or syndicate access to the CoinGecko API or part thereof. Learn more about our API terms here.
If your product or service requires a custom license (such as but not limited to redistribution of data and white labeling) outside of our standard API terms, please consider subscribing to an Enterprise plan. Flexibility is provided to the Pro plan on a case by case basis.
Reach out to our team at api@coingecko.com to advise on your specific needs. - Can I tailor the subscription plan to fit my needs?
-
If you are uncertain whether the current subscription tiers suit your needs, do speak to us at api@coingecko.com, and we may tailor a customised enterprise plan to fit within your budget.
- What are my payment options?
-
Credit card payment (Visa, Mastercard, American Express, Discover & JCB) is the default payment for Analyst, Lite and Pro plans.
However, we also accept USD Bank Transfer and selected crypto payment if you're committing to an Annual subscription. Please drop us an email at api@coingecko.com for payment arrangement.
For Enterprise plans, reach out to us at api@coingecko.com and our team can better brief you on the payment options. - What are the overage charges like?
-
You will be charged $250 for every 500,000 calls made.
- How does CoinGecko API count the API usage credit?
-
1 call = 1 credit. Calling any endpoint will only count as 1 call.
- When does my request volume (monthly API credit) reset?
-
Regardless of your billing cycle, your requests are counted from the first day of the month to the last.
If you start your subscription sometime after the first day of the month, you'll still receive your full quota of requests for that partial month. Then on the first day of the following month, your request will reset again. - What is the refund policy of CoinGecko API subscription?
-
All payments must be made in advance prior to the commencement/start date of your usage plan and each recurring billing cycle thereafter) and are non-refundable (whether in whole or in part).
- What are the differences between Analyst, Lite, Pro & Enterprise Plan?
-
The Analyst plan is well suited for those who are looking for personal use that requires a higher rate limit and exclusive access to more features.
Meanwhile, the Lite or Pro plan will be a better option to support small to medium size projects.
For large-scale enterprise or startups with large usage volume and would require a customisation plan to fit their business needs, the Enterprise plan will be the right fit. - I am interested in the paid plans. Is there a trial for paid plans before making a purchase?
-
For Pro and Enterprise plans, we are able to provide up to two weeks trial (on a case by case basis) for users who are interested in making the switch. Should you find the plan to be sufficient to meet your needs, drop us an email at api@coingecko.com, and we will be in touch with you shortly. Do note that we do not support overage billing for trial plans.
- When does my subscription expire?
-
For users who subscribe month to month subscription plans, it would expire at the end of each calendar month which begins on your date of activation. As for annual subscription, the subscription plan would expire within 365 days of purchase. Do note that auto renewal is turned on by default to ensure uninterrupted services for our users.
- Can I roll over any unused requests?
-
We do not offer such feature to roll over unused requests to the following month for the time being. When your subscription renews, the requests are being reset.
- I would like to cancel my subscription, how should I go about that?
-
If you’d like to cancel your subscription, simply head over to your Developer Dashboard and click on the “API Plan Details” in the green tab.
If you do not see such an option on your Developer Dashboard, kindly reach out to our API team via api@coingecko.com to initiate the cancellation process. - How do I upgrade or downgrade my subscription plan?
-
Please visit API plans pricing page pricing page to change your subscription plan.
If you face any difficulty, kindly drop us a email at api@coingecko.com, and we would assist in reviewing your needs. - Do you provide an SLA?
-
Yes, we provide SLA’s for our Enterprise clients. Contact us at api@coingecko.com to learn more.
- Where can I find my API key?
-
Your API Key would only reveal once you have generated the API key in the Developers Dashboard. Do note that if the API key is compromised, you will need to delete this key and generate a new API key.
- Where do I pass the Pro API key (any paid plans) when making a request?
-
You can supply your Pro API key in one of two ways:
1. Header: x-cg-pro-api-key
2. Query string parameter: x_cg_pro_api_key
Note: Pro API key is currently only available for CoinGecko API paid plan subscribers, all API key request should target this domain https://pro-api.coingecko.com. You are recommended to store the API key securely in your own backend and use a proxy to insert the key into the request URL. - How often does data get refreshed or updated?
-
This depends - but endpoints are all cached to around 1 to 5 minutes and you can expect most data to be updated at similar intervals unless otherwise specified. Pro API (paid plans) generally have faster update frequency, i.e. 30 sec for simple/price endpoint.
This also means that as a user, you should try to throttle your response to ensure that you are not wasting bandwidth by making calls too frequently. - How far back is the historical data?
-
You can access up to 9+ years worth of historical data using our API, starting from 2014.
This is subject to availability, as certain cryptocurrencies may not have full range of data points if the exchange is not supported at time of trading commencement. - What is the historical data availability or granularity?
-
For historical data, granularity is automatically determined and cannot be adjusted with the following rules :
• 1 day from query time = 5 minute interval data
• 1 - 90 days from query time = hourly data
• above 90 days from query time = daily data (00:00 UTC) - Where can I find the token lists specific to a chain (for e.g. Arbitrum)?
-
You would have to identify the ID for the chain you are looking for using the asset platform endpoint. Once you have identified the ID, replace the correct ID in this link https://tokens.coingecko.com/<ID>/all.json
In this case, it would be https://tokens.coingecko.com/arbitrum-one/all.json
- How quickly would the support team respond?
-
Due to a large number of incoming queries, please note that our support team will reach out to you within 48 hours.
- I have questions that are not listed here, where can I seek help?
-
Please visit our help center for the full list of questions. You may also drop us a message via support.coingecko.com.
- Is there a call consumption alert?
-
Yes! Just head over to the developer’s dashboard and click on the Call Consumption Alerts tab to enable it. Note that users will receive an email once the threshold value of 50% and 90% is hit respectively.
- I have reached 100% of my monthly calls consumption. What should I do?
-
It is your responsibility to review and monitor the plan's usage limitation by keeping track of your monthly quota usage to prevent overages. You can do this by tracking the number of API calls via the Developer Dashboard for up-to-date usage statistics.
Once you have reached 100% monthly calls consumption, we will be adding more requests to your account. You will be billed overages as an additional charge and added to the following month's invoice.
Feel free to reach out to our team to discuss the options available in upgrading to a higher tier plan to accommodate your increasing usage. - Can I turn off overage billing?
-
Yes. Overage billing is enabled by default. However, users with a paid subscription plan have the option to disable overage billing through the developer dashboard.
- Is there an endpoint to check the number of calls used for the month/per minute?
-
We do not have this endpoint at the moment, however we are looking into implementing this in our roadmap.
- How can I differentiate between the status codes I am receiving and what do they mean?
-
The server responds to a user’s request by issuing status codes when the request is made to the server. Kindly refer to the table below to further understand the status codes when indicating the success or failure of an API call.