# Odds API REST

**Canonical:** https://apis.io/apis/odds-api/odds-api-rest/  
**Provider:** Odds API — https://apis.io/providers/odds-api/  
**Base URL:** https://api.odds-api.net/v1  
**Documentation:** https://odds-api.net/docs

Odds API REST is published by [Odds API](https://apis.io/providers/odds-api/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Sports, Sports Betting, betting-odds, bookmaker-odds, and live-odds. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, an API reference, and pricing.

REST API for sports and racing betting odds with SSE and WebSocket streaming, arbitrage, positive EV, line movement, bookmaker comparison, and results. API-key auth via X-API-Key.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | Start here: API metadata |
| GET | `/status` | API status: Public health summary |
| GET | `/me` | Account: Current identity |
| GET | `/usage` | Account: Usage |
| GET | `/limits` | Account: Limits |
| GET | `/sports` | Catalog: Sports |
| GET | `/leagues` | Catalog: Leagues |
| GET | `/bookmakers` | Catalog: Bookmakers |
| GET | `/bookmakers/countries` | Catalog: Bookmaker countries |
| GET | `/coverage` | Catalog: Coverage |
| GET | `/widgets/odds-ticker` | Widgets: Odds ticker |
| GET | `/events` | Sports events: Search |
| GET | `/events/live` | GET events live |
| GET | `/events/{event_id}` | Sports events: Event details |
| GET | `/events/{event_id}/bookmakers` | Sports events: Bookmaker coverage |
| GET | `/events/{event_id}/odds/snapshot` | Event odds: Snapshot |
| GET | `/events/{event_id}/odds/stream` | Event odds: Stream (SSE) |
| GET | `/events/{event_id}/odds/ws` | Event odds: Stream (WebSocket) |
| GET | `/events/{event_id}/odds/history` | Event odds history: Snapshot |
| GET | `/events/{event_id}/odds/history/stream` | Event odds history: Stream (SSE) |
| GET | `/events/{event_id}/odds/history/ws` | Event odds history: Stream (WebSocket) |
| GET | `/events/{event_id}/exchange/orderbook/snapshot` | Event exchange order book: Snapshot |
| GET | `/events/{event_id}/exchange/orderbook/stream` | Event exchange order book: Stream (SSE) |
| GET | `/events/{event_id}/exchange/orderbook/ws` | Event exchange order book: Stream (WebSocket) |
| GET | `/events/{event_id}/exchange/markets` | In-play exchange: Discover markets |
| GET | `/exchange/betfair/events/{betfair_event_id}/markets` | In-play exchange: Discover by Betfair event ID |
| GET | `/exchange/orderbooks/ws` | In-play exchange: Multiplexed WebSocket |
| GET | `/exchange/tennis/scores/ws` | Live tennis scores: Multiplexed WebSocket |
| GET | `/events/{event_id}/prediction-markets/orderbook/snapshot` | Prediction-market order book: Snapshot |
| GET | `/events/{event_id}/prediction-markets/orderbook/stream` | Prediction-market order book: Stream (SSE) |
| GET | `/events/{event_id}/prediction-markets/orderbook/ws` | Prediction-market order book: Stream (WebSocket) |
| GET | `/racing/events` | Racing events: Search |
| GET | `/racing/events/stream` | Racing events: Stream (SSE) |
| GET | `/racing/events/ws` | Racing events: Stream (WebSocket) |
| GET | `/racing/events/{event_id}` | Racing events: Event details |
| GET | `/racing/events/{event_id}/odds` | Racing odds: Snapshot |
| GET | `/racing/events/{event_id}/odds/stream` | Racing odds: Stream (SSE) |
| GET | `/racing/events/{event_id}/odds/ws` | Racing odds: Stream (WebSocket) |
| GET | `/bets/snapshot` | Betting opportunities: Snapshot |
| GET | `/bets/stream` | Betting opportunities: Stream (SSE) |
| GET | `/bets/ws` | Betting opportunities: Stream (WebSocket) |
| GET | `/events/{event_id}/results` | Results: Event result |

## Machine-readable artifacts (26)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/openapi/odds-api-openapi.json
- **OpenAPI** — https://api.odds-api.net/v1/openapi.json
- **OpenAPI** — https://github.com/odds-api/odds-api/blob/main/openapi.yaml
- **PostmanCollection** — https://github.com/odds-api/odds-api/blob/main/postman/odds-api.postman_collection.json
- **Documentation** — https://odds-api.net/docs
- **Documentation** — https://api.odds-api.net/v1/reference
- **LLMsTxt** — https://odds-api.net/llms.txt
- **AgentSkill** — https://github.com/odds-api/odds-api/blob/main/AGENTS.md
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/overlays/odds-api-overlay.yaml
- **MCPServer** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/mcp/odds-api-mcp.yml
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/mcp/odds-api-tool-crosswalk.yml
- **SDKs** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/packages/odds-api-packages.yml
- **Packages** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/packages/odds-api-packages.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/errors/odds-api-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/conventions/odds-api-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/data-model/odds-api-data-model.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/sandbox/odds-api-sandbox.yml
- **Plans** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/plans/odds-api-plans-pricing.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/rate-limits/odds-api-rate-limits.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/conformance/odds-api-conformance.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/lifecycle/odds-api-lifecycle.yml
- **StatusPage** — https://odds-api.net/sla-status-support
- **APIReference** — https://api.odds-api.net/v1/reference
- **Pricing** — https://odds-api.net/pricing
- **SignUp** — https://odds-api.net/signup
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/odds-api/refs/heads/main/apis.yml

## Tags

Sports, Sports Betting, betting-odds, bookmaker-odds, live-odds, Sportsbook, Racing, REST, Server-Sent Events, WebSocket, OpenAPI, MCP, agent-native, llms-txt, SDK, Postman

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/odds-api/odds-api-rest/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/odds-api/.