Rate Limiting

Default limits

Every API key is rate-limited to prevent abuse and ensure fair access.

Limit	Default
Requests per minute	60
Per-key override	Configurable per key

Every response includes rate-limit headers:

Header	Description
`X-RateLimit-Limit`	Max requests allowed in the window
`X-RateLimit-Remaining`	Requests remaining
`X-RateLimit-Reset`	Unix timestamp when the window resets

When you exceed the limit, the API returns 429 Too Many Requests with a Retry-After header:

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Retry after 12 seconds."
  }
}

Read the Retry-After header

The header value tells you how many seconds to wait.

Back off and retry

Use exponential backoff: wait the Retry-After value, then double on each subsequent retry.

Optimize your calls

Batch operations where possible and cache responses to reduce call volume.