> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://coingecko.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://coingecko.ferndocs.com/_mcp/server.

# Setting Up Your API Key

👋 **New to CoinGecko API?** Sign up for an account [here](https://www.coingecko.com/en/api/pricing)

## 1. Creating a new API Key

* Once you have signed up and logged in to your CoinGecko account, go to [Developer Dashboard](https://www.coingecko.com/en/developers/dashboard):

  ![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/d5fdca3-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=01b58675fd1f038e4998877c0dde2cce)

* Click on **+ Add New Key** button to create a new API key:

  ![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/0e2f30d-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=49cf69a9b5ada9685301fe90281ec4ca)

## 2. Making API Request

* **Root URLs:**
  * Pro API: `https://pro-api.coingecko.com/api/v3/`, refer to [Pro API Authentication](/api-reference).
  * Demo API: `https://api.coingecko.com/api/v3/`, refer to [Demo API Authentication](https://docs.coingecko.com/v3.0.1/reference/authentication).
* **Example using the `/ping` endpoint:**

  * Pro API: `https://pro-api.coingecko.com/api/v3/ping?x_cg_pro_api_key=YOUR_API_KEY`
  * Demo API: `https://api.coingecko.com/api/v3/ping?x_cg_demo_api_key=YOUR_API_KEY`

  ![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/27ff800-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=e3d99147f58fba36640e1bfe509349b1)

## 3. Edit or Delete API Key

* Go to the Developer Dashboard and click the "Edit" button on a specific API Key.
* In case the API Key is compromised, you may delete the API Key by clicking the "Delete" button.
* You may also update the label and save the changes by clicking the "Save" button.

  ![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/cf29b58-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=106da6dd2c0954fdac0b343222bd47d0)

## 4. API Usage Report

* You can monitor your API usage in the Usage Report section, which provides details such as:

  * Total Monthly API Calls.
  * Remaining Monthly API Calls.
  * Rate Limit (Request Per Minute) — maximum number of API requests allowed in one minute.
  * Last Used — the timestamp of the last used instance.

  ![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/c436404-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=731ada28dc58aa21345e3ad74f79638a)

* You can also check your full historical usage by specifying "API Keys", "timeframe" or "date range". You may export as CSV for a more comprehensive view.

  ![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/ed3143e-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=fdebb203ab2f8c54dd4d2b57188131e6)

## 5. Others

### Call Consumption Alerts

You may enable or disable call consumption alerts in the tab below to receive emails when specific credit usage thresholds are reached.

![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/752e839-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=0152d66e48fe99fe40f6738f1b9a196c)

### Overage Option (Beta)

* The overage option enables you to make API calls when your usage exceeds the monthly credits.
* You can activate the overage option by clicking the "Turn On Overage" button, ensuring uninterrupted service and allowing you to continue making API calls or vice versa.

![](https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/b4711e6-image.png?fit=max\&auto=format\&n=a7cplMjqO5fc2v5e\&q=85\&s=6d293516eea9798436bd1a28fcf55cd8)