Rate Limits
Egret enforces rate limits per API key to ensure fair usage and platform stability.
Default limits
| Plan | Requests/min | Requests/day |
|---|---|---|
| Starter | 30 | 5,000 |
| Professional | 60 | 20,000 |
| Enterprise | Custom | Custom |
Rate limit headers
Every response includes headers to help you track usage:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests in the current window |
X-RateLimit-Remaining | Requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
Credit limits
In addition to request rate limits, each plan has a monthly credit quota. When credits are exhausted, query endpoints return 429 with credit_limit_exceeded. You can check remaining credits via the billing endpoint.
Handling rate limits
When you receive a 429 response, wait until the X-RateLimit-Reset time before retrying. We recommend implementing exponential back-off with jitter.