Rate Limits & Credits

Rate limits

Two rate limits are enforced per API key:

Limit	Value
Per second	1 request/second
Per minute	15 requests/minute

Exceeding either limit returns 429 Too Many Requests:

{
  "detail": "Rate limit exceeded (15 req/min)"
}

Monthly credits

Each API key gets 50,000 credits per month. Each request consumes 1 credit. Credits reset on the 1st of each month at 00:00 UTC.

When credits are exhausted:

{
  "detail": "Monthly credit limit exhausted (50,000/month). Credits reset on the 1st of each month (UTC).",
  "credits_remaining": 0,
  "credits_reset": "2026-04-01T00:00:00Z"
}

Tracking your usage

Every successful response includes credit headers:

Header	Description
X-Credits-Remaining	Credits left in current period
X-Credits-Limit	Total credits per period (50,000)
X-Credits-Reset	ISO timestamp when credits reset

You can also check your balance without consuming a credit:

curl -H "x-api-key: YOUR_API_KEY" \
  YOUR_API_BASE_URL/api/credits

{
  "credits_remaining": 49950,
  "credits_limit": 50000,
  "credits_reset": "2026-04-01T00:00:00Z",
  "period": "2026-03"
}