# 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 (242 currently active) 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)
- 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
- 1,000+ developers worldwide

## 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
- 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/value-bets — Find value betting opportunities (expected value calculation)
- GET /v3/arbitrage-bets — Find arbitrage opportunities across bookmakers
- GET /v3/participants — Get teams/participants for a sport
- 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 odds streaming

## Pricing

- Free tier: 100 requests/hour, no credit card required — perfect for testing
- 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

## Contact

- Email: hello@odds-api.io