Usage

Read your monthly request quota and consumption for the authenticated API key.

◆ Endpoints

GET/v2/usageMonthly usage

GET/v2/usage

Monthly usage

Returns the authenticated key's monthly usage counters. Does not consume quota beyond the cost of the HTTP call itself. Use this to backoff before hitting 429s or to drive alerts in your integration.

◆ Parameters

No parameters.

◆ Response

Field	Type	Description
tier	string	Active plan for the authenticated API key (e.g. `free`, `pro`).
periodYm	string	UTC calendar month for the counters (`YYYY-MM`). Matches AWS usage-plan billing period.
requestCount	integer	Requests counted against your monthly quota so far this period (same source as AWS enforcement).
monthlyQuota	integer	Plan monthly cap. `null` on Enterprise (custom contract).
remaining	integer	Requests left before the monthly cap. `null` when `monthlyQuota` is unlimited.
quotaResetAt	iso8601	When the monthly counter resets (first instant of the next UTC month).

◆ Request

curl -X GET "https://api.coinmarketcal.com/v2/usage" \
  -H "x-api-key: $COINMARKETCAL_API_KEY" \
  -H "Accept: application/json"

◆ Example response

{
  "tier": "pro",
  "periodYm": "2026-07",
  "requestCount": 12450,
  "monthlyQuota": 300000,
  "remaining": 287550,
  "quotaResetAt": "2026-08-01T00:00:00.000Z"
}

◆ Try it

API keysent as `x-api-key` · saved locally

Loading your keys…

No parameters. Sends straight to the API.

→ https://api.coinmarketcal.com/v2/usage