API Usage - CoinGecko API

API Usage

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/key \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "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
}

GET

key

API Usage

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/key \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "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
}

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

For a more comprehensive overview of your API usage, visit the Developer Dashboard.

SDK Examples

New to the SDK? Install and authenticate the client first:
TypeScript | Python

const response = await client.key.get();

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

response = client.key.get()

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Response

200 - application/json

API usage

plan

string

required

Current subscription plan

rate_limit_request_per_minute

integer

required

Rate limit per minute for the plan

monthly_call_credit

integer

required

Total monthly API call credits for the plan

current_total_monthly_calls

integer

required

Total API calls made this month for the account, across all API keys

current_remaining_monthly_calls

integer

required

Remaining API call credits this month for the account, across all API keys

api_key_rate_limit_request_per_minute

integer

required

Rate limit per minute configured for this API key

api_key_monthly_call_credit

integer

required

Monthly call credit limit configured for this API key

api_key_current_total_monthly_calls

integer

required

Total API calls made this month by this API key