> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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):

  <Frame>
    <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/d5fdca3-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=01b58675fd1f038e4998877c0dde2cce" width="2535" height="1454" data-path="images/reference/d5fdca3-image.png" />
  </Frame>

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

  <Frame>
    <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/0e2f30d-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=49cf69a9b5ada9685301fe90281ec4ca" width="2380" height="1695" data-path="images/reference/0e2f30d-image.png" />
  </Frame>

## 2. Making API Request

* **Root URLs:**
  * Pro API: `https://pro-api.coingecko.com/api/v3/`, refer to [Pro API Authentication](/reference/authentication).
  * Demo API: `https://api.coingecko.com/api/v3/`, refer to [Demo API Authentication](/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`

  <Frame>
    <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/27ff800-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=e3d99147f58fba36640e1bfe509349b1" width="1784" height="604" data-path="images/reference/27ff800-image.png" />
  </Frame>

## 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.

  <Frame>
    <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/cf29b58-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=106da6dd2c0954fdac0b343222bd47d0" width="2372" height="1054" data-path="images/reference/cf29b58-image.png" />
  </Frame>

## 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.

  <Frame>
    <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/c436404-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=731ada28dc58aa21345e3ad74f79638a" width="2373" height="1047" data-path="images/reference/c436404-image.png" />
  </Frame>

* 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.

  <Frame>
    <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/ed3143e-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=fdebb203ab2f8c54dd4d2b57188131e6" width="2108" height="1328" data-path="images/reference/ed3143e-image.png" />
  </Frame>

## 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.

<Frame>
  <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/752e839-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=0152d66e48fe99fe40f6738f1b9a196c" width="2112" height="1044" data-path="images/reference/752e839-image.png" />
</Frame>

### 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.

<Frame>
  <img src="https://mintcdn.com/coingecko/a7cplMjqO5fc2v5e/images/reference/b4711e6-image.png?fit=max&auto=format&n=a7cplMjqO5fc2v5e&q=85&s=6d293516eea9798436bd1a28fcf55cd8" width="2218" height="1074" data-path="images/reference/b4711e6-image.png" />
</Frame>
