> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.