> ## 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.

# API Rate Limits - Request Quotas & Throttling

> OddsPapi API rate limits and quotas. Request limits per endpoint, rate limit headers, and best practices for handling 429 responses.

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:

```json theme={null}
{
  "error": 429,
  "message": "rate limit exceeded",
  "code": "rate_limited",
  "retryAfterSec": 1
}
```