Rate Limiting

The API enforces rate limits to ensure fair usage. Rate limit information is returned in response headers.

Rate limit headers

Every response includes these headers:

• X-RateLimit-Limit — Maximum requests per window
• X-RateLimit-Remaining — Requests remaining in current window
• X-RateLimit-Reset — Unix timestamp when the window resets

Exceeding the limit

If you exceed the rate limit, the API returns a 429 Too Many Requests status code:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please retry after 30 seconds."
  }
}