Pinnacle Odds API for Football
Use Pinnacle football odds as the sharp-price benchmark for closing line value and model validation.
Quick Answer
TheStatsAPI provides Pinnacle football odds through the match odds endpoint, alongside Bet365, Paddy Power, Betfair Sportsbook, and Kambi prices. Developers use Pinnacle as the sharp, low-margin reference book, deriving no-vig fair-value probabilities from its lines when measuring whether a prediction model beat the market.
- Endpoint:
/football/matches/{match_id}/odds - Best for: CLV and model validation.
- Availability varies by match, competition, bookmaker, and market.
At a glance
Why Pinnacle odds matter
Pinnacle is useful because its prices are commonly treated as a sharp market benchmark. If your football model consistently beats Pinnacle last-seen or closing prices where available, it has stronger evidence of predictive edge than if it only beats softer retail prices.
- Benchmark model probability against market probability
- Compare sharp prices with retail books
- Measure closing line value over a long sample
How to use Pinnacle with TheStatsAPI
Fetch the match odds response, isolate the Pinnacle bookmaker object, then compare opening and last-seen prices against your own model probabilities or against retail prices from Bet365, Paddy Power, and Betfair Sportsbook. Pinnacle's low-margin lines make the best fair-value benchmark once you strip the vig.
- Convert decimal odds into implied probability
- Remove margin before comparing model edge
- Store opening and last-seen values for audit trails
Pinnacle odds response
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: Sharp reference prices for CLV and model validation.
Bet365 odds API
Retail football odds from the sportsbook most bettors check first.
Closing line value API
Closing line value workflows using Bet365, Pinnacle, and Betfair Sportsbook prices.
Closing odds API
Latest stored pre-kickoff prices for CLV and prediction benchmarking.
Historical football odds API
Opening and last-seen prices for backtesting and model analysis.
Frequently Asked Questions
Does TheStatsAPI provide Pinnacle odds?
Yes. Pinnacle appears as a bookmaker in supported football match odds responses where Pinnacle prices are available.
Why use Pinnacle for CLV?
Pinnacle is commonly used as a sharp benchmark because its prices are more efficient than many retail books. Comparing your entry price against Pinnacle close helps evaluate whether your model is finding real value.
Can I compare Pinnacle and Bet365 in one response?
Yes. Supported matches can include Pinnacle, Bet365, Paddy Power, Betfair Sportsbook, and Kambi bookmaker objects in the same odds response.
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.