Soccer is the largest league catalogue we carry — 19 competitions across Europe, the Americas and international football. Because the calendars overlap, a single sport-level query keeps a product busy almost every day of the year, from a Tuesday Champions League night to a Sunday MLS fixture.
This page covers association football. If you are looking for American football — the NFL, college football, CFL, USFL and XFL — see our football odds API.
Soccer Odds API Features
One request returns a match's entire odds tree. There is no separate props endpoint, no per-bookmaker stitching, and no second integration needed to settle bets afterwards.
Available soccer betting markets include:
- Match winner (1X2) and draw no bet
- Asian handicaps and European handicaps
- Totals (over/under goals), team totals, and both teams to score
- Alternative lines and totals
- Goalscorer markets — anytime, first and last
- Player props — shots, shots on target, assists, tackles, passes, cards
- Goalkeeper props — saves and goals against
- Card and corner markets, plus first and second half variants
Market depth is greatest in the major European leagues and the UEFA competitions, where the full prop catalogue is posted. The South American and second-tier leagues reliably carry core markets — 1X2, handicaps and totals — with props where individual sportsbooks price them.
Quick Start: Every Soccer League in One Call
Querying at the sport level means you do not have to enumerate 19 competitions. A single sportID=SOCCER request spans all of them:
https://api.sportsgameodds.com/v2/events?apiKey=YOUR_API_KEY&sportID=SOCCER&oddsAvailable=true&limit=10
For a specific subset, leagueID accepts a comma-separated list — here the big five European leagues:
https://api.sportsgameodds.com/v2/events?apiKey=YOUR_API_KEY&leagueID=EPL,LA_LIGA,BUNDESLIGA,IT_SERIE_A,FR_LIGUE_1&oddsAvailable=true&limit=10
Note that leagueID takes precedence — if you send both sportID and leagueID, the league filter is used and the sport filter is ignored. Use one or the other.
To narrow to a single market, add oddIDs. Shots on target are carried under the shots_onGoal statID, so this returns shots on target over/unders for every player on the slate:
https://api.sportsgameodds.com/v2/events?apiKey=YOUR_API_KEY&sportID=SOCCER&oddsAvailable=true&oddIDs=shots_onGoal-PLAYER_ID-game-ou-over,shots_onGoal-PLAYER_ID-game-ou-under
OddIDs follow the format {statID}-{statEntityID}-{periodID}-{betTypeID}-{sideID}. The full list is in the stats reference, and markets & coverage shows which books support what.
Try it Out
See live odds for an upcoming match
https://api.sportsgameodds.com/v2/eventsRequest Parameters
leagueID=MLBOnly NBA games
oddsAvailable=trueOnly games with available odds
includeAltLines=falseDon't return alt-lines
limit=1Number of games to return
Soccer Leagues We Cover
England
- Premier League (EPL) — all 20 clubs across the 38-match season, the most heavily traded league in world football.
- EFL Cup — the English Football League Cup.
Europe — top flights
- La Liga (Spain) · Bundesliga (Germany) · Serie A (Italy) · Ligue 1 (France) · Eredivisie (Netherlands)
Europe — second tiers
- La Liga Segunda (Spain) · Serie B (Italy) · Ligue 2 (France)
UEFA competitions
The Americas
- MLS (United States) · Liga MX (Mexico) · Brasileiro Série A (Brazil) · Liga Profesional (Argentina) · Primera A (Colombia) · Liga 1 (Peru)
International
- International Soccer — national team fixtures, qualifiers and tournaments.
Soccer Player Props
Goals (anytime, first and last scorer); assists and goals + assists; shots, shots on goal and shots assisted; tackles, clearances, fouls committed and drawn, dribbles attempted and passes attempted; goalkeeper saves and goals against; yellow cards, red cards and combined cards. Full-match markets plus first and second half variants where books post them.
Props come back in the same response as the match lines and are identified by a single field, so filtering to only props — or excluding them — is one check. See the soccer player prop odds API for the complete market list by sport.
Soccer Odds API with Results
Odds and results arrive in one unified response, so you can settle bets without adding a second data source. Each response includes:
- Live and upcoming matches across every covered competition
- Home and away team data
- Player and match statistics
- Full odds coverage — 1X2, handicaps, totals, goalscorer and player props, alternate lines
- Final scores and settlement data
Line movement is tracked throughout, which matters in soccer because prices move sharply on confirmed team news — a rested striker or an absent first-choice keeper can shift a market an hour before kickoff.
Soccer Odds API Technical Specifications
API Architecture
- REST API — standard HTTP endpoints returning clean JSON
- WebSocket feeds — real-time push updates on the All-Star plan, no polling required
- Rate limits — scalable plans matched to your usage volume
- Authentication — secure API key access
Data Update Speed
- Odds updates — sub-minute refresh on the Pro plan; Rookie and the free Amateur tier refresh on a longer interval. See pricing for the frequency on each tier.
- Live scores — updated in real time during matches, including stoppage time
Developer Resources
- Interactive documentation — live examples and copy-paste snippets
- SDKs & libraries — JavaScript/TypeScript, Python, Ruby, Go and Java
- Postman collection — pre-built requests ready to run
- Dedicated technical support across paid plans
Use Cases for Soccer Odds Data
Odds Comparison Platforms — Show 1X2 and handicap prices from 85+ bookmakers side by side across a full European matchday.
Arbitrage & +EV Tools — Late team news creates short-lived pricing gaps between books, and soccer's fixture volume means they appear constantly.
Goalscorer & Player Prop Tools — Surface anytime goalscorer odds, shots on target and assist props across every fixture, updating as confirmed lineups drop.
Sports Analytics & Research — Study how markets respond to team news, fixture congestion and European competition rotation across a full season of data.
Betting Automation — Monitor soccer lines across bookmakers and trigger actions when your target price appears.
Sportsbook & Fantasy Apps — Power your platform with real-time soccer odds across a calendar that runs nearly year-round.
Soccer Odds API Documentation
Our interactive documentation covers everything needed to integrate soccer odds:
- Full endpoint reference with parameters and response schemas
- Live request and response examples
- Code snippets in Python, JavaScript and more
- Authentication setup and API key management
- Error handling and troubleshooting
For Premier League query examples see the EPL odds API page, or read our guides to international soccer coverage and Premier League betting markets.
Frequently Asked Questions
Which soccer leagues does the API cover?
Does this cover soccer or American football?
How do I get odds for every soccer league in one request?
What soccer player props are available?
Are Asian handicap markets supported?
How often do soccer odds update?
Is there a free soccer odds API?
How does object-based pricing work for soccer?
Ready to get started?
Join thousands of developers building the next generation of sports and betting applications.