# Motorsports Odds API
URL: https://sockodds.com/sports/motorsports-odds-api/

> Access motorsports betting odds from every Australian bookmaker through the SockOdds API. Motorsports odds for Formula 1 including head to head, lines, totals, player props and more.

Access motorsports betting odds from 9 bookmakers through the SockOdds API. Get motorsports odds for every race including head to head, lines, totals, player props and more — `sportID=MOTOR_RACING`.

## Motorsports Odds API Features

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

7 distinct markets are priced across 1 league 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 (race and season)

## Motorsports leagues

| League | leagueID | Events | Markets | Bookmakers |
| --- | --- | --- | --- | --- |
| [Formula 1](https://sockodds.com/leagues/f1-odds-api/) | `F1` | 3 | 7 | 9 |

## Motorsports Player Props

Access 7 motorsports player proposition markets — race winner, podium, constructor and championship markets — pre-match across every race the Australian books price. See the [player prop odds API](https://sockodds.com/player-props-odds-api/) for the full market list by sport and how to filter props in a single request.

## Motorsports API Odds with Results

SockOdds delivers motorsports odds and event data in one configuration:

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

## Quick start: your first Motorsports odds API call

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

Or one league at a time, which is faster:

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

## Stats priced in motorsports

| statID | Name | Markets | Levels |
| --- | --- | --- | --- |
| `podium` | Podium | 22 | player |
| `points` | Points / score | 22 | player |
| `raceWins` | Race wins | 22 | player |
| `championship` | Championship | 22 | player |
| `constructorRace` | Constructor race | 11 | player |
| `constructorRaceWins` | Constructor race wins | 11 | player |
| `constructorChampionship` | Constructor championship | 11 | player |

## Motorsports 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

### Motorsports market coverage by category

| Market category | Example markets | Markets | Availability | Typical bookmakers |
| --- | --- | --- | --- | --- |
| **Player props** | Podium yes/no, Points / score, Constructor race, Constructor race wins O/U, Constructor championship, Race wins O/U, Championship | 7 oddIDs | Pre-match | [Picklebet](https://sockodds.com/bookmakers/picklebet-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [Pinnacle](https://sockodds.com/bookmakers/pinnacle-odds-api/), [Ladbrokes](https://sockodds.com/bookmakers/ladbrokes-odds-api/) |

## Use Cases for Motorsports API Data

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

## Motorsports Odds API Documentation

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