# TopBet Odds API
URL: https://sockodds.com/bookmakers/topbet-odds-api/

> Access TopBet betting odds through the SockOdds API. Structured JSON including head to head, lines, totals, player props and more, keyed bookmakerID=topbet.

Access TopBet betting odds through the SockOdds API. Structured JSON data including head to head, lines, totals, player props and more — `bookmakerID=topbet`, with lanes `topbet__sgm_only`.

## Why choose our TopBet sportsbook API?

Our TopBet API provides clean, structured TopBet odds data for developers and betting platforms, eliminating the need for scraping or unstable data feeds. Australian bookmaker on the Punterstech platform, with a same-game-multi lane.

## TopBet Odds API Overview

The SockOdds TopBet odds API provides fast, accurate data and odds from TopBet across 5 leagues: [NFL](https://sockodds.com/leagues/nfl-odds-api/), [MLS](https://sockodds.com/leagues/mls-odds-api/), [ATP](https://sockodds.com/leagues/atp-odds-api/), [AFLW](https://sockodds.com/leagues/aflw-odds-api/), [WTA](https://sockodds.com/leagues/wta-odds-api/). 83 events are priced by TopBet right now.

With a single, unified API solution, developers can retrieve pre-match TopBet odds, including:

- 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 (quarters, halves, innings, sets, rounds)

All data is provided in structured JSON via REST endpoints, refreshed every ~2 minutes.

## TopBet API Features & Market Types

### Main markets

- **Head to head** — 2-way and 3-way lines
- **Line / handicap** — spreads with the price
- **Totals** — over/under lines for points, goals, runs and more
- **Period markets** — halves, quarters, innings, sets, rounds where priced

### Player props & alternate lines

TopBet prices 8 distinct player-prop markets in the feed — Points / score, First to score, Last to score, Cards, Touchdowns, Last Touchdown — plus alternative spreads and totals, team props and game props.

### Pre-match data

- **Pre-game odds** — current odds before game time, with `decimal` alongside the American string
- **Availability** — a suspended selection is listed with `available: false`, never dropped silently
- **Line movement tracking** — every price carries `lastUpdatedAt`, and finished events are retained

### Deeplinks & settlement data

- **Deeplinks** — not yet carried for TopBet
- **Results** — event results and `scoringSupported` flags where the source grades the market

## TopBet coverage by league

| League | leagueID | Events priced |
| --- | --- | --- |
| [NFL](https://sockodds.com/leagues/nfl-odds-api/) | `NFL` | 155 |
| [MLS](https://sockodds.com/leagues/mls-odds-api/) | `MLS` | 141 |
| [ATP](https://sockodds.com/leagues/atp-odds-api/) | `ATP` | 44 |
| [AFLW](https://sockodds.com/leagues/aflw-odds-api/) | `AFLW` | 36 |
| [WTA](https://sockodds.com/leagues/wta-odds-api/) | `WTA` | 22 |

## TopBet Odds API Technical Specifications

### API Architecture

- **REST API** — Simple HTTP endpoints with JSON responses, identical to the SportsGameOdds v2 paths
- **Native WebSocket snapshots** - Pro/Platform at `/v2/stream/events`; polling-backed, with unchanged upstream freshness
- **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

### TopBet market coverage by category

| Market category | Example markets | Markets | Availability | Typical bookmakers |
| --- | --- | --- | --- | --- |
| **Full game lines** | Points / score O/U, Points / score line, Points / score 1X2, Points / score | 18 oddIDs | Pre-match | [BearBet](https://sockodds.com/bookmakers/bearbet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [CashCage](https://sockodds.com/bookmakers/cashcage-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [LightningBet](https://sockodds.com/bookmakers/lightningbet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/) |
| **Period markets** | Points / score O/U, Points / score line, Points / score 1X2, Both teams to score yes/no, Points / score | 20 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [CashCage](https://sockodds.com/bookmakers/cashcage-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [LightningBet](https://sockodds.com/bookmakers/lightningbet-odds-api/), [BearBet](https://sockodds.com/bookmakers/bearbet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/) |
| **Score & margin specials** | First to score, Half-time / full-time, Correct score, Winning margin | 70 oddIDs | Pre-match | [BearBet](https://sockodds.com/bookmakers/bearbet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [CashCage](https://sockodds.com/bookmakers/cashcage-odds-api/), [Chasebet](https://sockodds.com/bookmakers/chasebet-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Star Sports](https://sockodds.com/bookmakers/starsports-odds-api/) |
| **Team & game specials** | Points / score, Both teams to score yes/no, Win to nil yes/no, Team scores in both halves yes/no, Games O/U, Games line | 12 oddIDs | Pre-match | [BearBet](https://sockodds.com/bookmakers/bearbet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [Chasebet](https://sockodds.com/bookmakers/chasebet-odds-api/), [LightningBet](https://sockodds.com/bookmakers/lightningbet-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [CashCage](https://sockodds.com/bookmakers/cashcage-odds-api/) |
| **Cards, corners & shots** | Corners 1X2, Corners O/U, Shots on goal O/U, Cards O/U, Cards 1X2 | 11 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [CashCage](https://sockodds.com/bookmakers/cashcage-odds-api/), [BearBet](https://sockodds.com/bookmakers/bearbet-odds-api/), [Chasebet](https://sockodds.com/bookmakers/chasebet-odds-api/), [LightningBet](https://sockodds.com/bookmakers/lightningbet-odds-api/) |
| **Player props** | Points / score O/U, Points / score yes/no, First to score yes/no, Last to score yes/no, Cards yes/no, Touchdowns yes/no, Last Touchdown yes/no | 8 oddIDs | Pre-match | [BearBet](https://sockodds.com/bookmakers/bearbet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [CashCage](https://sockodds.com/bookmakers/cashcage-odds-api/), [Chasebet](https://sockodds.com/bookmakers/chasebet-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [TopBet](https://sockodds.com/bookmakers/topbet-odds-api/) |

## Use Cases for TopBet API Data

- [Arbitrage](https://sockodds.com/use-cases/arbitrage-betting-api/) & [+EV tools](https://sockodds.com/use-cases/positive-ev-betting-api/) — compare TopBet 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 TopBet odds from every book side by side for comprehensive line shopping.
- **Pricing models & trading** — use TopBet market data as inputs for proprietary pricing algorithms and betting strategies.
- [Sports analytics & research](https://sockodds.com/use-cases/sports-betting-machine-learning/) — examine TopBet 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 TopBet 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 TopBet product with reliable odds, status and bet-slip deeplinks.

## TopBet Odds API Documentation

Our interactive documentation covers everything you need to integrate TopBet 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.