Rate limits
Requests are rate-limited per API key using a fixed window. The default limit is 30 requests per minute per key.
Response headers
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed in the current window. |
X-RateLimit-Remaining | Requests remaining in the current window. |
Retry-After | On 429, seconds to wait before retrying. |
When you hit the limit
Exceeding the limit returns 429 rate_limited. Read Retry-After, wait, and retry. For sustained high throughput, contact us about a higher limit.
Best practices
- Spread bursts out; don’t fire all requests at once.
- Implement exponential backoff on
429and5xx. - Use an
Idempotency-Keyon retries to avoid double-charging.