Skip to main content

Upgrade to Pro

Get higher rate limits, more credits, and access to premium endpoints.
1

Get your API key

Sign up and grab your key from the Developer Dashboard.
2

Choose an auth method

MethodKeyExample
Header (recommended)x-cg-demo-api-key-H "x-cg-demo-api-key: YOUR_API_KEY"
Query stringx_cg_demo_api_key?x_cg_demo_api_key=YOUR_API_KEY
3

Make a request

All requests use the Demo API root URL: https://api.coingecko.com/api/v3/
curl "https://api.coingecko.com/api/v3/ping" \
  -H "x-cg-demo-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://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.
  • Monthly credits and rate limits depend on your plan.
  • Check usage in the Developer Dashboard.