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

# API Usage

> To monitor your account's API usage, including rate limits, monthly total credits, remaining credits, and more

#### Notes

* `current_total_monthly_calls` and `current_remaining_monthly_calls` are account-level values, counted across all API keys.
* `api_key_*` fields apply to the API key used to make the request. Per-key rate limit and credit controls are available on the [Enterprise plan](https://www.coingecko.com/en/api/enterprise) only.

> [!TIP]
>
> For a more comprehensive overview of your API usage, visit the [Developer Dashboard](https://www.coingecko.com/en/developers/dashboard).

**Basic Plan and Above**
This endpoint is only available to **Basic, Analyst, Lite, Pro, and Enterprise** plan.
[→ View pricing](https://www.coingecko.com/en/api/pricing)

#### SDK Examples

New to the SDK? Install and authenticate the `client` first:\

[TypeScript](https://docs.coingecko.com/docs/sdk-typescript.md) | [Python](https://docs.coingecko.com/docs/sdk-python.md)

```typescript TypeScript theme={null}
const response = await client.key.get();

console.log(JSON.stringify(response, null, 2));
```

```python Python theme={null}
response = client.key.get()

print(response.model_dump_json(indent=2))
```


## OpenAPI

````yaml openapi-specs/pro-api.json get /key
openapi: 3.0.0
info:
  title: CoinGecko Pro API
  version: 3.0.0
servers:
  - url: https://pro-api.coingecko.com/api/v3
security:
  - headerAuth: []
  - queryAuth: []
paths:
  /key:
    get:
      summary: API Usage
      description: >-
        To monitor your account's API usage, including rate limits, monthly
        total credits, remaining credits, and more
      operationId: api-usage
      responses:
        '200':
          description: API usage
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiUsage'
              example:
                plan: Other
                rate_limit_request_per_minute: 1000
                monthly_call_credit: 1000000
                current_total_monthly_calls: 32
                current_remaining_monthly_calls: 999968
                api_key_rate_limit_request_per_minute: 1000
                api_key_monthly_call_credit: 1000000
                api_key_current_total_monthly_calls: 8
components:
  schemas:
    ApiUsage:
      type: object
      required:
        - plan
        - rate_limit_request_per_minute
        - monthly_call_credit
        - current_total_monthly_calls
        - current_remaining_monthly_calls
        - api_key_rate_limit_request_per_minute
        - api_key_monthly_call_credit
        - api_key_current_total_monthly_calls
      properties:
        plan:
          type: string
          description: Current subscription plan
        rate_limit_request_per_minute:
          type: integer
          description: Rate limit per minute for the plan
        monthly_call_credit:
          type: integer
          description: Total monthly API call credits for the plan
        current_total_monthly_calls:
          type: integer
          description: Total API calls made this month for the account, across all API keys
        current_remaining_monthly_calls:
          type: integer
          description: >-
            Remaining API call credits this month for the account, across all
            API keys
        api_key_rate_limit_request_per_minute:
          type: integer
          description: Rate limit per minute configured for this API key
        api_key_monthly_call_credit:
          type: integer
          description: Monthly call credit limit configured for this API key
        api_key_current_total_monthly_calls:
          type: integer
          description: Total API calls made this month by this API key
  securitySchemes:
    headerAuth:
      type: apiKey
      in: header
      name: x-cg-pro-api-key
      description: >-
        Learn how to [set up your API
        key](https://docs.coingecko.com/docs/setting-up-your-api-key)
    queryAuth:
      type: apiKey
      in: query
      name: x_cg_pro_api_key
      description: >-
        Learn how to [set up your API
        key](https://docs.coingecko.com/docs/setting-up-your-api-key)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.