1
Get your API key
Sign up and grab your key from the Developer Dashboard.
2
Choose an auth method
| Method | Key | Example |
|---|---|---|
| Header (recommended) | x-cg-pro-api-key | -H "x-cg-pro-api-key: YOUR_API_KEY" |
| Query string | x_cg_pro_api_key | ?x_cg_pro_api_key=YOUR_API_KEY |
3
Make a request
All requests use the Pro API root URL:
https://pro-api.coingecko.com/api/v3/curl "https://pro-api.coingecko.com/api/v3/ping" \
-H "x-cg-pro-api-key: YOUR_API_KEY"
Replace YOUR_API_KEY with your key from the Developer Dashboard.
Onchain endpoints use the same authentication — just include
/onchain in the path.e.g. https://pro-api.coingecko.com/api/v3/onchain/simple/networks/...Store your API key in your backend and use a proxy to inject it into requests.Avoid query string parameters in production — they risk exposing your key in logs and browser history.
Done setting up your key?
Connect it to AI agents via MCP, SDK prompts, and coding agent integrations.
Usage Credits
- Each successful request (HTTP 200) deducts 1 credit from your monthly quota.
- Failed requests (4xx, 5xx) do not consume credits, but still count toward your per-minute rate limit.
- Monthly credits and rate limits depend on your plan.
- Check usage in the Developer Dashboard.