CoinGecko Crypto Data API Plans

Sure thing - you may find our API documentation here.

Nope, our Public API is accessible without API key. Try our API to check Bitcoin’s current price here.

Do check here or this Google Sheets for the full list of coins and their respective identifiers. With over 10,000+ different cryptocurrencies available for query, coin names may not be unique and cannot be used directly as the identifier.

You may check out our tutorial guidebook here!

Yes! Here is a step-by-step guide on how you can use our API on your Google Sheets.

Definitely! You may refer to the step-by-step guide on how you can use our API on Microsoft Excel here.

Our Public API has a rate limit of 10-30 calls per minute, if you exceed that limit you will be blocked until the next 1 minute window. Do revise your queries to ensure that you do not exceed our limits should that happen.

Sure thing - follow us here on our API Newsletter! We’ll only send API related news and nothing else.

You can find our Terms of Service here.

You can find the API changelog here.

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.

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.

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.

You will be charged $250 for every 500,000 calls made.

1 call = 1 credit. Calling any endpoint will only count as 1 call.

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.

The Analyst plan is well suited for those who are looking for personal use that requires a higher rate limit than what is given on the public API 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.

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.

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.

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.

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.

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.

Yes, we provide SLA’s for our Enterprise clients. Contact us at api@coingecko.com to learn more.

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.

You can supply your API key in one of two ways:
1. Header: x-cg-pro-api-key
2. Query string parameter: x_cg_pro_api_key

Note: 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.

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.

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.

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)

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

Due to a large number of incoming queries, please note that our support team will reach out to you within 48 hours.

Please visit our help center for the full list of questions. You may also drop us a message via email api@coingecko.com.

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.

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.

The overage billing is enabled by default at the moment. There is no option to turn the overage billing off currently.

We do not have this endpoint at the moment, however we are looking into implementing this in our roadmap.

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.