> For the complete documentation index, see [llms.txt](https://coingecko-api.gitbook.io/coingecko-api-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coingecko-api.gitbook.io/coingecko-api-guide/getting-started/error-and-rate-limit.md).

# Error & Rate Limit

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.

<table><thead><tr><th width="251">Status codes</th><th>Description</th></tr></thead><tbody><tr><td>400 (Bad Request)</td><td>This is due to an invalid request and the server could not process the user's request.</td></tr><tr><td>401 (Unauthorised)</td><td>This is due to the lack of valid authentication credentials for the requested resource by the user.</td></tr><tr><td>429 (Too many requests)</td><td>This is likely indicating that the rate limit has reached. The user should reduce the number of calls made, or consider scaling their service plan that has much higher rate limits and call credits.<br><br>To upgrade your plans, kindly refer to: <a href="https://www.coingecko.com/en/api/pricing">https://www.coingecko.com/en/api/pricing</a> .</td></tr><tr><td>503 (Service Unavailable)</td><td>The service is currently unavailable. Please check the API status and updates on <a href="https://status.coingecko.com/">https://status.coingecko.com/</a></td></tr><tr><td>500 (Internal Server Error)</td><td>This is a generic error response indicating that the server has encountered an unexpected issue that prevented it from fulfilling the request.</td></tr><tr><td>10002 (API Key Missing)</td><td>You have provided incorrect API key credentials. Please check your keys in developer dashboard and ensure that your request is <a href="https://apiguide.coingecko.com/getting-started/authentication">authorised</a>.</td></tr><tr><td>10005</td><td>You may not have access to this endpoint. E.g. 'This request is limited Pro API subscribers'. You may wanna subscribe to a paid plan <a href="https://www.coingecko.com/en/api/pricing">here</a>.</td></tr><tr><td>403 (Forbidden)</td><td>This is likely indicating that your access is blocked by our server, and we're unable to authorise your request.</td></tr><tr><td>1020 (Access Denied)</td><td>This is due to violation of CDN firewall rule.</td></tr><tr><td>CORS error</td><td>A CORS error occurs when the server doesn’t return the CORS headers required. You may learn more and attempt the recommended solutions <a href="https://www.bannerbear.com/blog/what-is-a-cors-error-and-how-to-fix-it-3-ways/#how-to-fix-a-cors-error">here</a>.</td></tr></tbody></table>

## Rate Limit

* For Public API user, the rate limit is 10-30/min and it varies depending on the traffic size.&#x20;
* If you're Pro API user, the rate limit is depending on the [paid plan](https://www.coingecko.com/en/api/pricing) that you're subscribed to.

Note: if you're using the public API with Google Sheet and got hit with error, this is due to the IP sharing among Google Sheet users, and we have no control over this. If you need reliable performance, please subscribe to a [paid plan](https://www.coingecko.com/en/api/pricing) that comes with dedicated infra (API key) to prevent rate limit issues.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://coingecko-api.gitbook.io/coingecko-api-guide/getting-started/error-and-rate-limit.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.