API Reference
🤝 Get HelpFeedbackPricingEnterpriseDeveloper Dashboard

🔓 Authentication (Public/Demo)

Authentication method for CoinGecko Public API (Demo plan users)

📘

Notes

  • Demo API Key is only available for CoinGecko Public Demo API Plan, the root URL for CoinGecko Public Demo API must be https://api.coingecko.com/api/v3/
  • You are recommended to store the API key securely in your own backend and use a proxy to insert the key into the request URL
  • The authentication method below is for CoinGecko Public Demo API only. For paid plan users with Pro-API key, please refer to this page instead.
  • User Guide: How to sign up for CoinGecko Demo API and generate an API key?

CoinGecko API Authentication Method

If this is your first time using the Demo API key, you can supply API Key to the root URL using one of these ways:

  1. Header: x-cg-demo-api-key
  2. Query String Parameter: x_cg_demo_api_key
Authentication MethodExample using Ping Endpoint
Header (cURL)curl -X GET "https:/api.coingecko.com/api/v3/ping" -H "x-cg-demo-api-key: YOUR_API_KEY"
Query String Parameterhttps://api.coingecko.com/api/v3/ping?x_cg_demo_api_key=YOUR_API_KEY

API Key Usage Credits

  • Each request made to any endpoint counts as a single call (1 call = 1 credit)
  • Your monthly credit & rate limit are determined by the paid plan to which you subscribe. For more details, please refer to this page
  • To check the API usage, please go to the developer dashboard or follow the guide here