Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Rate limits are counted per apiKey and by endpoint.

​
Limits

​
Odds endpoints (high-frequency)

These endpoints allow higher throughput:
  • GET /fixtures/odds
  • GET /fixtures/odds/main
  • GET /futures/odds
Limit: 10 requests / second

​
All other endpoints

Everything else (metadata, fixtures list, mapping, settlements, historical, media redirects): Limit: 200 requests / minute

​
Rate limit headers

Every response includes:
  • X-RateLimit-Limit
  • X-RateLimit-Remaining
  • X-RateLimit-Reset
When limited (429), responses also include:
  • Retry-After

​
What happens when you exceed limits

You’ll receive:
  • 429 with code: "rate_limited"
Example: 
{
  "error": 429,
  "message": "rate limit exceeded",
  "code": "rate_limited",
  "retryAfterSec": 1
}