Rate Limits

Gildea uses fixed-window rate limiting on both per-minute and monthly windows.

Limits by tier

Monthly limits use a rolling 30-day window.

Every authenticated response includes rate limit headers:

X-RateLimit-Limit-Minute: 30
X-RateLimit-Remaining-Minute: 28
X-RateLimit-Limit-Monthly: 2000
X-RateLimit-Remaining-Monthly: 1847

If you exceed your limit, the API returns 429:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded",
    "status": 429
  }
}

The response includes a Retry-After header (in seconds):

Retry-After: 60

Check remaining counts — use the X-RateLimit-Remaining-* headers to throttle proactively
Respect Retry-After — wait the indicated time before retrying
Use pagination — fetch fewer, larger pages instead of many small requests
Cache responses — signal data doesn’t change frequently