Errors & Rate Limits

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.

All requests count toward your per-minute rate limit — including 4xx and 5xx errors.

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.

Get Started

Guides

Resources

Error Codes

HTTP Status Codes

CoinGecko Error Codes

Rate Limits

​Error Codes

​HTTP Status Codes

​CoinGecko Error Codes

​Rate Limits

Error Codes

HTTP Status Codes

CoinGecko Error Codes

Rate Limits