Closing Odds API for Football
Use latest stored pre-kickoff football odds as a benchmark for model validation and closing line value analysis.
Quick Answer
Closing odds are the market prices immediately before kickoff. TheStatsAPI stores last-seen pre-match prices for supported matches, so developers can use those values as a closing-price proxy when a dedicated final-close snapshot is not available.
- Endpoint:
/football/matches/{match_id}/odds - Best for: CLV and model benchmarking.
- Availability varies by match, competition, bookmaker, and market.
At a glance
Why closing odds are the benchmark
Closing odds incorporate the most information the market has before kickoff. Model builders use final or latest stored pre-match prices to test whether their predictions beat the market, not just the final score.
- Validate signal quality over many bets
- Avoid judging models only by short-term results
- Compare retail and sharp market prices
How to calculate CLV
Store your model price at bet time, fetch the last-seen price before kickoff, then compare implied probabilities. Positive CLV means your entry price beat the later market price.
- Convert odds into implied probability
- Compare entry price to closing price
- Aggregate by league, market, and bookmaker
Closing odds fields
Odds responses stay focused on bookmaker prices. Match context comes from related football endpoints, so your app can join odds to fixtures, results, xG, team stats, and player data by match ID.
GET https://api.thestatsapi.com/api/football/matches/{match_id}/odds
Authorization: Bearer YOUR_API_KEY
{
"data": {
"match_id": "mt_14502",
"bookmakers": [
{
"bookmaker": "Pinnacle",
"markets": {
"match_odds": {
"home": { "opening": "2.150", "last_seen": "2.080" },
"draw": { "opening": "3.400", "last_seen": "3.500" },
"away": { "opening": "3.200", "last_seen": "3.300" }
},
"total_goals": {
"over": { "opening": "1.890", "last_seen": "1.900" },
"under": { "opening": "1.930", "last_seen": "1.920" }
}
}
}
]
}
}Coverage, bookmakers & update frequency
Bookmakers
Markets
Live vs pre-match & latency
Related Odds API Pages
Current topic: Latest stored pre-kickoff prices for CLV and prediction benchmarking.
Closing line value API
Closing line value workflows using Bet365, Pinnacle, and Betfair Sportsbook prices.
Pinnacle odds API
Sharp reference prices for CLV and model validation.
Historical football odds API
Opening and last-seen prices for backtesting and model analysis.
Odds comparison API
Multi-bookmaker football odds for comparison apps and price screens.
Frequently Asked Questions
What field should I use for closing odds?
Use last_seen on the pre-match odds response as the stored final or latest captured price for supported matches.
Are closing odds available for every match?
Availability varies by match, competition, bookmaker, and market. Use odds availability flags and handle missing bookmaker markets safely.
Why compare against Pinnacle close?
Pinnacle close is commonly used as a sharp market benchmark for CLV and model validation.
Simple, Transparent Pricing
Odds across multiple sports — events, latest odds, and fair prices.
Starter
For prototypes and early odds-driven products
Included in every odds plan:
- Pre-match & live odds across multiple sports
- Sports, leagues & events reference endpoints
- Latest odds snapshots (moneyline, spread, totals)
- 100,000 requests/month
- 120 requests/min
- Email & chat support
Growth
For production apps consuming live odds
Everything in Starter, plus:
- 500,000 requests/month
- 300 requests/min
- Full odds movement history (price timeline per match)
- Priority support for production teams
Scale
For high-volume, production-grade odds usage
Everything in Growth, upgraded to:
- 5,000,000 requests/month
- 1,000 requests/min
- Dedicated support & SLA
Build with football odds and match context in one API.
Start a 7-day free trial with odds, fixtures, match stats, player data, team data, and xG endpoints available on every plan.