Get usage information

Get current usage information for the authenticated API key.

Returns plan and organization details, rate-limit usage, and plan capabilities.

GET https://api.polymarketdata.co/v1/usage

Get usage information

cURL

curl --request GET \
  --url https://api.polymarketdata.co/v1/usage \
  --header 'X-API-Key: <api-key>'

200

Example

{
  "plan": "trader",
  "organization": "Acme Corp",
  "limits": {
    "requests_per_minute": 100,
    "requests_remaining": 95,
    "granularity_allowed": "1m",
    "max_history_days": 30,
    "data_points": {
      "metrics": true,
      "prices": true,
      "books": true
    }
  },
  "reset_at": 1706184000
}

Authorizations

X-API-Key · string · header · required

Create an API key in the PolymarketData dashboard and send it in the X-API-Key request header.

Example: X-API-Key: pk_live_your_key_here

Response

200

application/json

Usage information including plan and limits

Response body for GET /usage.

plan · string · required

Plan name for the current API key.

organization · string · required

Organization name associated with the API key.

limits · UsageLimitsResponse · object · required

Rate-limit and plan capability information.

Show child attributes

reset_at · integer | null

Unix timestamp (seconds) when the rate-limit window resets. Null for unlimited plans.