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, Betfair Exchange, and Kambi prices. Developers use Pinnacle as the sharp reference book 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 prices from Bet365 and Betfair Exchange.
- 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" }
}
}
}
]
}
}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 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, Betfair Exchange, and Kambi bookmaker objects in the same odds response.
Simple, Transparent Pricing
Every plan includes stats, odds, xG, history, and every documented endpoint.
Starter
For growing applications and side projects
- All football data endpoints included
- Pre-match & live odds endpoints
- Bet365, Pinnacle, Betfair Exchange & Kambi odds
- 1X2, Asian handicap, totals, BTTS, DNB & corners
- Fixtures, results, match stats, teams & players
- xG, player season stats & team stats
- 10 years of historical match data
- Build with AI
- 80 competitions by default, up to 1,196 on request
- 100,000 requests/month
- 30 requests/min
- Email & chat support
Growth
For professional applications at scale
- All football data endpoints included
- Pre-match & live odds endpoints
- Bet365, Pinnacle, Betfair Exchange & Kambi odds
- 1X2, Asian handicap, totals, BTTS, DNB & corners
- Fixtures, results, match stats, teams & players
- xG, player season stats & team stats
- 10 years of historical match data
- Build with AI
- 80 competitions by default, up to 1,196 on request
- 500,000 requests/month
- 60 requests/min
- Priority support
Scale
For high-volume, production-grade usage
- All football data endpoints included
- Pre-match & live odds endpoints
- Bet365, Pinnacle, Betfair Exchange & Kambi odds
- 1X2, Asian handicap, totals, BTTS, DNB & corners
- Fixtures, results, match stats, teams & players
- xG, player season stats & team stats
- 10 years of historical match data
- Build with AI
- 80 competitions by default, up to 1,196 on request
- 5,000,000 requests/month
- 300 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.