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. |
500 Internal Server Error | Unexpected server error. |
503 Service Unavailable | Check 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. |
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.
- Demo plan: 100 calls/min.
- Keyless (no API key): IP-based rate limiting — shared across all users on the same IP.
Using the API via Google Sheets?
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.
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.