# Odds API (odds-api.io)

> Real-time sports betting odds API with data from 265+ bookmakers across 34 sports via a single REST API.

## What is Odds API?

Odds API is a B2B REST API that provides real-time and historical sports betting odds from 265+ bookmakers across 34 sports. It serves developers building odds comparison sites, arbitrage tools, value bet finders, trading bots, and sports analytics platforms.

## Key Facts

- 265+ bookmakers (Bet365, DraftKings, FanDuel, Betfair, SBOBET, BetMGM, Unibet, SingBet, and more)
- 34 sports (Football, Basketball, Tennis, NFL, NBA, NHL, MLB, Esports, Cricket, and more)
- 12,000+ leagues and competitions worldwide
- Pre-match and live/in-play odds
- 100+ market types (ML, Asian Handicap, Totals, Player Props, Correct Score, and more)
- Value bet detection and arbitrage opportunity detection
- Historical odds data and odds movement tracking
- WebSocket real-time streaming
- Direct bet links to bookmaker sites
- 99.9% uptime SLA
- <150ms average response time
- 10,000+ developers worldwide
- Live scores and match status streaming over WebSocket (~1 second updates)

## API Endpoints

Base URL: https://api.odds-api.io/v3

### No Authentication Required
- GET /v3/sports — List available sports
- GET /v3/bookmakers — List available bookmakers

### Authenticated (apiKey required)
- GET /v3/leagues — List leagues for a sport
- GET /v3/events — List events (filter by sport, league, status, bookmaker, date range)
- GET /v3/events/live — Get currently live events (includes optional clock object: minute, playedSeconds, period, running, statusDetail, serve, injuryTime)
- GET /v3/events/search — Search events by text query
- GET /v3/events/{id} — Get event by ID
- GET /v3/odds — Get odds for a specific event from selected bookmakers
- GET /v3/odds/multi — Get odds for multiple events in one call (up to 10, counts as 1 request)
- GET /v3/odds/updated — Get odds updated since a timestamp (for incremental polling)
- GET /v3/odds/movements — Get historical odds movements for a market
- GET /v3/markets — List available betting markets
- GET /v3/historical/events — List past events for a sport/league/season
- GET /v3/historical/events/search — Search past events by text query
- GET /v3/historical/odds — Get historical odds for a past event
- GET /v3/historical/closing-lines — Get closing lines for a past event
- GET /v3/value-bets — Find value betting opportunities (expected value calculation)
- GET /v3/arbitrage-bets — Find arbitrage opportunities across bookmakers
- GET /v3/dropping-odds — Get dropping odds from sharp bookmakers (paid plans only)
- GET /v3/participants — Get teams/participants for a sport
- GET /v3/participants/{id}/logo — Get participant crest as PNG (hotlinkable, served from our domain)
- GET /v3/bookmakers/selected — Get user's selected bookmakers
- PUT /v3/bookmakers/selected/select — Select bookmakers for your account
- WebSocket wss://api.odds-api.io/v3/ws — Real-time streaming; channels parameter selects odds, scores and status (e.g. ?channels=odds,scores,status)

## Error Handling & Rate Limits

HTTP status codes (standard REST):
- 200 — Success
- 400 — Bad Request (invalid/missing parameters; e.g. `league` without `sport`, unknown `sport` slug)
- 401 — Unauthorized (invalid or missing API key)
- 403 — Forbidden (API key lacks access to the resource/plan feature)
- 404 — Not Found (unknown resource; e.g. unknown `league` for a valid sport)
- 429 — Too Many Requests (rate limit exceeded)
- 500 — Internal Server Error

Rate limits:
- Free tier: 100 requests/hour
- All paid plans (Starter/Growth/Pro): 5,000 requests/hour
- Optional add-on capacity: +10K/+20K/+30K requests/hour
- Every response returns rate-limit headers: `x-ratelimit-limit`, `x-ratelimit-remaining`, and `x-ratelimit-reset` (ISO 8601 reset timestamp)

Handling limits:
- On a 429, implement exponential backoff and retry after the `x-ratelimit-reset` time
- Monitor `x-ratelimit-remaining` to stay under the limit
- Use GET /v3/odds/multi to fetch up to 10 events in one call (counts as a single request)

## Esports Coverage

Odds API is also an esports odds API, covering 550+ upcoming esports matches across 15 titles: Counter-Strike (CS2), Valorant, League of Legends, Dota 2, Rainbow Six Siege, StarCraft 2, Rocket League, LoL Wild Rift, Mobile Legends, King of Glory, EA Sports FC, PUBG, Overwatch, StarCraft: Brood War and Call of Duty. Esports events use sport=esports, with live scores updating in roughly one second and map/period-level markets (map handicap, total maps, first blood, round handicap, and more).

- Esports odds API overview: https://odds-api.io/esports-odds-api
- Per-title pages: https://odds-api.io/esports/cs2, https://odds-api.io/esports/valorant, https://odds-api.io/esports/league-of-legends, https://odds-api.io/esports/dota-2, https://odds-api.io/esports/rainbow-six, https://odds-api.io/esports/starcraft-2, https://odds-api.io/esports/rocket-league, https://odds-api.io/esports/wild-rift, https://odds-api.io/esports/mobile-legends, https://odds-api.io/esports/king-of-glory, https://odds-api.io/esports/ea-sports-fc, https://odds-api.io/esports/pubg, https://odds-api.io/esports/overwatch, https://odds-api.io/esports/starcraft-brood-war, https://odds-api.io/esports/call-of-duty

## Sports Coverage

Dedicated per-sport odds API pages (leagues covered, betting markets, bookmakers and FAQs):

- Football / Soccer: https://odds-api.io/sports/football
- NBA / Basketball: https://odds-api.io/sports/nba
- NFL / American Football: https://odds-api.io/sports/nfl
- Tennis: https://odds-api.io/sports/tennis
- MLB / Baseball: https://odds-api.io/sports/mlb
- NHL / Ice Hockey: https://odds-api.io/sports/nhl
- Cricket: https://odds-api.io/sports/cricket
- MMA / UFC: https://odds-api.io/sports/mma
- Boxing: https://odds-api.io/sports/boxing
- Golf: https://odds-api.io/sports/golf
- Darts: https://odds-api.io/sports/darts
- Rugby: https://odds-api.io/sports/rugby

## Pricing

- Free tier: 100 requests/hour, no credit card required — perfect for testing
- Solo: £49/month — 2 bookmakers, 5,000 req/hr
- Starter: £99/month — 5 bookmakers, 5,000 req/hr
- Growth: £179/month — 10 bookmakers, 5,000 req/hr
- Pro: £229/month — 15 bookmakers, 5,000 req/hr
- Add-on packages: 10K req/hr (£139), 20K req/hr (£229), 30K req/hr (£309)
- Enterprise: Custom pricing, unlimited requests, dedicated infrastructure

## SDKs

- Python: pip install odds-api-io
- Node.js/TypeScript: npm install odds-api-io
- MCP Server: npx odds-api-mcp-server (for AI assistants like Claude Desktop)

## Documentation

- Full docs: https://docs.odds-api.io
- Full docs for AI: https://docs.odds-api.io/llms-full.txt
- OpenAPI spec: https://docs.odds-api.io/api-reference/openapi.json
- Website: https://odds-api.io
- Blog: https://odds-api.io/blog
- API comparisons: https://odds-api.io/compare/the-odds-api
- Betting glossary: https://odds-api.io/glossary
- Sports betting API overview: https://odds-api.io/sports-betting-api
- Esports odds API overview: https://odds-api.io/esports-odds-api
- Supported bookmakers: https://odds-api.io/sportsbooks
- Free betting calculators: https://odds-api.io/tools

## Contact

- Email: hello@odds-api.io