# Tennis Odds API
URL: https://sockodds.com/sports/tennis-odds-api/

> Access tennis betting odds from every Australian bookmaker through the SockOdds API. Tennis odds for ATP, WTA including head to head, lines, totals, player props and more.

Access tennis betting odds from 24 bookmakers through the SockOdds API. Get tennis odds for every match including head to head, lines, totals, player props and more — `sportID=TENNIS`.

## Tennis Odds API Features

Our tennis odds API is fully filterable, so you pull exactly the data you want — matchs, player props, teams or specific markets. Curate the feed to your needs with the same parameters SportsGameOdds developers already know.

10 distinct markets are priced across 2 leagues right now:

- Head to head / moneylines (2-way and 3-way markets)
- Lines, spreads and handicaps
- Totals (over/under)
- Alternative lines
- Player props and game props
- Period-specific markets (sets)

## Tennis leagues

| League | leagueID | Events | Markets | Bookmakers |
| --- | --- | --- | --- | --- |
| [ATP](https://sockodds.com/leagues/atp-odds-api/) | `ATP` | 12 | 10 | 19 |
| [WTA](https://sockodds.com/leagues/wta-odds-api/) | `WTA` | 4 | 10 | 20 |

## Tennis Player Props

Player props for tennis are keyed like every other sport (the `playerID` in the `statEntityID` slot); the Australian books price tennis mainly at team and match level today. See the [player prop odds API](https://sockodds.com/player-props-odds-api/).

## Tennis API Odds with Results

SockOdds delivers tennis odds and event data in one configuration:

- Upcoming matchs with status flags
- Home and away teams with ids
- Players with production ids where the source carries them
- Tennis odds including lines, totals, head to head, player props and more
- Results and grading flags where the source has them

## Quick start: your first Tennis odds API call

```
https://api.sockodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&sportID=TENNIS&limit=10
```

Or one league at a time, which is faster:

```
https://api.sockodds.com/v2/events?apiKey=YOUR_API_KEY&oddsAvailable=true&leagueID=ATP&limit=10
```

## Stats priced in tennis

| statID | Name | Markets | Levels |
| --- | --- | --- | --- |
| `points` | Points / score | 78 | all, team |
| `games` | Games | 32 | all, team |

## Tennis Odds API Technical Specifications

### API Architecture

- **REST API** — Simple HTTP endpoints with JSON responses, identical to the SportsGameOdds v2 paths
- **Polling, not push** — the feed refreshes every ~2 minutes; `/v2/stream/events` is reserved and answers 501 rather than pretending
- **Rate limits** — per-key, per-minute meters that bind under concurrency; plans sized to your usage
- **Authentication** — secure API key access via the `x-api-key` header or `apiKey` query parameter

### Data Update Speed

- **Odds updates** — every ~2 minutes across every bookmaker lane
- **Event status** — `status` flags and `info.stale` tell you exactly how current a price is

### Developer Resources

- [Interactive documentation](https://sockodds.com/docs/) — live examples, copy-paste snippets and an [AI (vibe coding)](https://sockodds.com/docs/info/ai-vibe-coding/) context
- [SDKs & libraries](https://sockodds.com/docs/sdk/) — the SportsGameOdds SDKs for TypeScript, Python, Ruby, Go and Java work unchanged with the base URL pointed here
- [Postman collection](https://sockodds.com/postman-collection/) — pre-built requests ready to run
- [Support](https://sockodds.com/docs/help/) — email support on every plan, priority on paid plans

### Tennis market coverage by category

| Market category | Example markets | Markets | Availability | Typical bookmakers |
| --- | --- | --- | --- | --- |
| **Full game lines** | Points / score O/U, Points / score line, Points / score | 6 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [Picklebet](https://sockodds.com/bookmakers/picklebet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [Betfair Exchange](https://sockodds.com/bookmakers/betfairexchange-odds-api/) |
| **Team & game specials** | Games O/U, Games line | 4 oddIDs | Pre-match | [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [CrownBet](https://sockodds.com/bookmakers/crownbet-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Pinnacle](https://sockodds.com/bookmakers/pinnacle-odds-api/) |

## Use Cases for Tennis API Data

- [Arbitrage](https://sockodds.com/use-cases/arbitrage-betting-api/) & [+EV tools](https://sockodds.com/use-cases/positive-ev-betting-api/) — compare tennis odds across every Australian bookmaker to uncover arbitrage opportunities and positive expected value angles.
- [Odds comparison platforms](https://sockodds.com/use-cases/odds-comparison-api/) — display tennis odds from every book side by side for comprehensive line shopping.
- **Pricing models & trading** — use tennis market data as inputs for proprietary pricing algorithms and betting strategies.
- [Sports analytics & research](https://sockodds.com/use-cases/sports-betting-machine-learning/) — examine tennis line movements and betting-market patterns, and build predictive models on retained events.
- [Betting automation](https://sockodds.com/use-cases/odds-alert-bot-api/) — build systems that monitor tennis lines across bookmakers and trigger actions when your target odds appear.
- [Sportsbook & fantasy apps](https://sockodds.com/use-cases/sports-betting-app-api/) — power your tennis product with reliable odds, status and bet-slip deeplinks.

## Tennis Odds API Documentation

Our interactive documentation covers everything you need to integrate Tennis odds into your project:

- Full endpoint reference with parameters and response schemas
- Live request and response examples
- Code snippets in Python, JavaScript, Ruby, Go and Java
- Authentication setup and API key management
- Rate limiting and the `notice` field
- Error handling and troubleshooting

[View documentation](https://sockodds.com/docs/)

## Start building today

Free plan available. Set up in 5 minutes. Scale when you're ready.
