# Soccer Odds API
URL: https://sockodds.com/sports/soccer-odds-api/

> Access soccer betting odds from every Australian bookmaker through the SockOdds API. Soccer odds for Brasileiro Série A, Bundesliga, Premier League, FIFA World Cup, Ligue 1, Iceland 1. deild, Besta deild, Serie A, La Liga, MLS, Scottish Premiership, Slovak 2. Liga, Slovak Super Liga, Champions League, Conference League, Champions League Qualifiers, Conference League Qualifiers, Europa League Qualifiers, Europa League including head to head, lines, totals, player props and more.

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

## Soccer Odds API Features

Our soccer 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.

478 distinct markets are priced across 19 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 (halves)

## Soccer leagues

| League | leagueID | Events | Markets | Bookmakers |
| --- | --- | --- | --- | --- |
| [Brasileiro Série A](https://sockodds.com/leagues/br-serie-a-odds-api/) | `BR_SERIE_A` | 19 | 261 | 9 |
| [Bundesliga](https://sockodds.com/leagues/bundesliga-odds-api/) | `BUNDESLIGA` | 27 | 314 | 15 |
| [Premier League](https://sockodds.com/leagues/epl-odds-api/) | `EPL` | 39 | 443 | 20 |
| [FIFA World Cup](https://sockodds.com/leagues/fifa-world-cup-odds-api/) | `FIFA_WORLD_CUP` | 1 | 263 | 9 |
| [Ligue 1](https://sockodds.com/leagues/fr-ligue-1-odds-api/) | `FR_LIGUE_1` | 27 | 346 | 18 |
| [Iceland 1. deild](https://sockodds.com/leagues/iceland-1-deild-odds-api/) | `ICELAND_1_DEILD` | 1 | 99 | 2 |
| [Besta deild](https://sockodds.com/leagues/iceland-besta-deild-odds-api/) | `ICELAND_BESTA_DEILD` | 3 | 120 | 2 |
| [Serie A](https://sockodds.com/leagues/it-serie-a-odds-api/) | `IT_SERIE_A` | 33 | 306 | 16 |
| [La Liga](https://sockodds.com/leagues/la-liga-odds-api/) | `LA_LIGA` | 41 | 305 | 18 |
| [MLS](https://sockodds.com/leagues/mls-odds-api/) | `MLS` | 96 | 317 | 19 |
| [Scottish Premiership](https://sockodds.com/leagues/scottish-premiership-odds-api/) | `SCOTTISH_PREM` | 6 | 140 | 2 |
| [Slovak 2. Liga](https://sockodds.com/leagues/slovak-2-liga-odds-api/) | `SLOVAK_2_LIGA` | 1 | 106 | 2 |
| [Slovak Super Liga](https://sockodds.com/leagues/slovak-super-liga-odds-api/) | `SLOVAK_SUPER_LIGA` | 2 | 147 | 2 |
| [Champions League](https://sockodds.com/leagues/uefa-champions-league-odds-api/) | `UCL` | 17 | 166 | 14 |
| [Conference League](https://sockodds.com/leagues/uefa-conference-league-odds-api/) | `UECL` | 1 | 41 | 10 |
| [Champions League Qualifiers](https://sockodds.com/leagues/uefa-champions-league-qualifiers-odds-api/) | `UEFA_CHAMPIONS_LEAGUE_QUALIFIERS` | 5 | 180 | 2 |
| [Conference League Qualifiers](https://sockodds.com/leagues/uefa-conference-league-qualifiers-odds-api/) | `UEFA_CONFERENCE_LEAGUE_QUALIFIERS` | 19 | 138 | 2 |
| [Europa League Qualifiers](https://sockodds.com/leagues/uefa-europa-league-qualifiers-odds-api/) | `UEFA_EUROPA_LEAGUE_QUALIFIERS` | 8 | 170 | 2 |
| [Europa League](https://sockodds.com/leagues/uefa-europa-league-odds-api/) | `UEL` | 2 | 42 | 9 |

## Soccer Player Props

Access 30 soccer player proposition markets — goalscorers, shots, shots on target, cards, corners, fouls and assists — pre-match across every match 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.

## Soccer API Odds with Results

SockOdds delivers soccer 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
- Soccer odds including lines, totals, head to head, player props and more
- Results and grading flags where the source has them

## Quick start: your first Soccer odds API call

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

Or one league at a time, which is faster:

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

## Stats priced in soccer

| statID | Name | Markets | Levels |
| --- | --- | --- | --- |
| `points` | Points / score | 31,312 | all, team, player |
| `correctScore` | Correct score | 18,994 | all |
| `firstToScore` | First to score | 9,964 | team, player |
| `lastToScore` | Last to score | 5,720 | team, player |
| `shots_onGoal` | Shots on goal | 3,930 | all, team, player |
| `combinedCards` | Cards | 3,910 | all, team, player |
| `winningMargin` | Winning margin | 3,398 | all, team |
| `cornerKicks` | Corners | 3,202 | all, team |
| `goals+assists` | Goals + assists | 2,882 | player |
| `assists` | Assists | 2,870 | player |
| `htft` | Half-time / full-time | 2,497 | all |
| `bothTeamsScored` | Both teams to score | 2,000 | all |
| `tackles` | Tackles | 1,969 | player |
| `winToNil` | Win to nil | 1,473 | team |
| `fouls` | Fouls | 1,358 | team, player |
| `cleanSheet` | Clean sheet | 970 | team |
| `winsEitherHalf` | Wins either half | 911 | team |
| `foulsDrawn` | Fouls drawn | 806 | player |
| `winsBothHalves` | Wins both halves | 793 | team |
| `teamGoalInBothHalves` | Team scores in both halves | 780 | team |
| `highestScoringHalf` | Highest scoring half | 606 | all |
| `whichTeamsScore` | Which teams score | 539 | all |
| `goalInBothHalves` | Goal in both halves | 484 | all |
| `teamWinFromBehind` | Win from behind | 468 | all, team |
| `bothTeamsScored2plus` | Both teams score 2+ | 440 | all |

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

### Soccer 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 | 23 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/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [betr (sportsbook)](https://sockodds.com/bookmakers/betrsportsbook-odds-api/) |
| **Period markets** | Points / score O/U, Points / score 1X2, Points / score line, Points / score, Both teams to score yes/no, First to score yes/no, Win to nil yes/no | 155 oddIDs | Pre-match | [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [Ladbrokes](https://sockodds.com/bookmakers/ladbrokes-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [Unibet](https://sockodds.com/bookmakers/unibet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/) |
| **Score & margin specials** | First to score, Half-time / full-time, Correct score, Winning margin, Last to score yes/no | 161 oddIDs | Pre-match | [SwiftBet](https://sockodds.com/bookmakers/swiftbet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [Ladbrokes](https://sockodds.com/bookmakers/ladbrokes-odds-api/) |
| **Team & game specials** | Points / score, Wins either half yes/no, Wins both halves yes/no, Both teams to score yes/no, Win to nil yes/no, Goal in both halves yes/no, Team scores in both halves yes/no | 55 oddIDs | Pre-match | [TAB](https://sockodds.com/bookmakers/tab-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [SwiftBet](https://sockodds.com/bookmakers/swiftbet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/) |
| **Cards, corners & shots** | Corners O/U, Corners 1X2, Shots on goal O/U, Corners, Cards O/U, Corners line, Cards 1X2 | 54 oddIDs | Pre-match | [Unibet](https://sockodds.com/bookmakers/unibet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [TABtouch](https://sockodds.com/bookmakers/tabtouch-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/) |
| **Player props** | Points / score O/U, First to score yes/no, Points / score yes/no, Last to score yes/no, Goals + assists yes/no, Shots on goal O/U, Assists yes/no | 29 oddIDs | Pre-match | [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Unibet](https://sockodds.com/bookmakers/unibet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [TABtouch](https://sockodds.com/bookmakers/tabtouch-odds-api/) |
| **Scorer props** | First goalscorer yes/no | 1 oddIDs | Pre-match | [Picklebet](https://sockodds.com/bookmakers/picklebet-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [PlayUp](https://sockodds.com/bookmakers/playup-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/) |

## Use Cases for Soccer API Data

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

## Soccer Odds API Documentation

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