📘
Notes

Pro API Key is only available for CoinGecko API paid plan subscribers, the root URL for CoinGecko Pro API must be https://pro-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.

It's highly recommended to use the Headers method when making API requests for better security. Using query string parameters can risk exposing your API key.

CoinGecko API Authentication Method

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

Header (Recommended): x-cg-pro-api-key
Query String Parameter: x_cg_pro_api_key

Authentication Method	Example using Ping Endpoint
Header (cURL)	`curl -X GET "https://pro-api.coingecko.com/api/v3/ping" -H "x-cg-pro-api-key: YOUR_API_KEY"`
Query String Parameter	`https://pro-api.coingecko.com/api/v3/ping?x_cg_pro_api_key=YOUR_API_KEY`

🔥 Accessing On-Chain DEX data (Beta)

You can now use the Pro-API key (exclusive to any paid plan subscriber) to call on-chain DEX data powered by GeckoTerminal.

📘
Notes

Authentication method for on-chain endpoints is exactly same as other endpoints.

When using the CG Pro API to access on-chain DEX data, include the /onchain endpoint path in the request.

Authentication Method	Example using Simple Token Price Endpoint
Header (cURL)	`curl -X GET "<https://pro-api.coingecko.com/api/v3/onchain/simple/networks/eth/token_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2>" -H "x-cg-pro-api-key: YOUR_API_KEY"`
Query String Parameter	`https://pro-api.coingecko.com/api/v3/onchain/simple/networks/eth/token_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2?x_cg_pro_api_key=YOUR_API_KEY`

API Key Usage Credits

Each request made to any endpoint counts as a single call (1 call = 1 credit).
Each successful API request (Status 200) will deduct 1 credit from your monthly credit allowance.
Unsuccessful Requests (Status 4xx, 5xx, etc) will not count towards credit deduction.
Regardless of the HTTP status code returned (including 4xx and 5xx errors), all API requests will count towards your minute rate limit.
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