Rate Limits
Every API key is subject to rate limits based on the plan tier it belongs to. Rate limits help ensure fair usage and keep the platform fast and reliable for everyone. If you need higher limits, consider upgrading your plan.
Limits by Plan
The table below outlines the request allowances and feature access for each plan tier:
| Plan | Requests/Month | Requests/Minute | Bookmakers | Edge Access |
|---|---|---|---|---|
| Free | 1,000 | 5 | None | No |
| Hobbyist | 50,000 | 30 | 1 per request | No |
| Pro | 500,000 | 120 | All | Yes |
| Enterprise | Unlimited | Unlimited | All | Yes |
Rate Limit Headers
Every API response includes headers that tell you where you stand relative to your current rate limit window. Use these to build smart retry logic and avoid hitting limits:
| Header | Description |
|---|---|
| X-RateLimit-Limit | Your per-minute request limit |
| X-RateLimit-Remaining | The number of requests remaining in the current window |
| X-RateLimit-Reset | Seconds until the current rate limit window resets |
Exceeding the Limit
If you exceed your rate limit, the API will return a 429 Too Many Requests response. When this happens, wait for the window to reset before retrying. Check the X-RateLimit-Reset header to know exactly how long to wait.
429 — Rate limit exceeded
{
"success": false,
"error": {
"code": 429,
"message": "Rate limit exceeded. Please wait before making another request."
}
}