> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors & Rate Limits

> HTTP status codes, CoinGecko error codes, and rate limit behavior

## Error Codes

### HTTP Status Codes

| Code                        | Description                                                                                                  |
| --------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `400` Bad Request           | Invalid request — check your parameters.                                                                     |
| `401` Unauthorized          | Missing or invalid API key.                                                                                  |
| `403` Forbidden             | Access blocked by the server.                                                                                |
| `408` Timeout               | Request took too long — usually caused by slow network on your end.                                          |
| `429` Too Many Requests     | Rate limit exceeded. Reduce call frequency or [upgrade your plan](https://www.coingecko.com/en/api/pricing). |
| `500` Internal Server Error | Unexpected server error.                                                                                     |
| `503` Service Unavailable   | Check [status.coingecko.com](https://status.coingecko.com) for outages.                                      |
| `1020` Access Denied        | Blocked by CDN firewall rule.                                                                                |

### CoinGecko Error Codes

| Code                    | Description                                                                                                 |
| ----------------------- | ----------------------------------------------------------------------------------------------------------- |
| `10002` Missing API Key | No API key provided. Pro API requires `x_cg_pro_api_key`, Demo API requires `x_cg_demo_api_key`.            |
| `10005` Plan Restricted | Endpoint not available on your plan. [View plans](https://www.coingecko.com/en/api/pricing).                |
| `10010` Invalid API Key | Wrong key type. If using a Pro key, your root URL must be `pro-api.coingecko.com`.                          |
| `10011` Invalid API Key | Wrong key type. If using a Demo key, your root URL must be `api.coingecko.com`.                             |
| CORS Error              | Server didn't return CORS headers. Proxy requests through your backend instead of calling from the browser. |

## Rate Limits

* **Paid plans:** Rate limit depends on your [plan](https://www.coingecko.com/en/api/pricing).
* **Demo plan:** 100 calls/min.
* **Keyless (no API key):** IP-based rate limiting — shared across all users on the same IP.

<Warning>
  All requests count toward your per-minute rate limit — including `4xx` and `5xx` errors.
</Warning>

<Note>
  **Using the API via Google Sheets?**<br />
  Rate limit errors may occur due to shared IP addresses among Google Sheets users. For reliable performance, use a dedicated API key with a [paid plan](https://www.coingecko.com/en/api/pricing).
</Note>