Closing Line Value (CLV) API
Measure whether your football model beats the market by comparing entry prices against last-seen and closing prices.
Quick Answer
TheStatsAPI supports CLV workflows by returning opening and last-seen odds for supported football matches. Compare your model or entry price against the last-seen market price, especially Pinnacle where available.
- Endpoint:
/football/matches/{match_id}/odds - Availability varies by match, competition, bookmaker, and market.
At a glance
Why CLV matters more than short-term ROI
Betting results are noisy. CLV gives model builders a cleaner signal: did your price beat the market before the match started? Over enough samples, positive CLV is stronger evidence than a lucky run of outcomes.
- Measure edge before results are known
- Segment performance by league and market
- Compare model quality across bookmakers
A practical CLV calculation
Convert your entry odds and the closing or last-seen odds to implied probability. Positive CLV means the later market price moved in your favor after your model identified the entry price.
- Store entry price and timestamp
- Fetch last_seen odds before kickoff
- Aggregate CLV by strategy, market, and bookmaker
CLV odds data
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: Closing line value workflows using Bet365, Pinnacle, and Betfair prices.
Closing odds API
Latest stored pre-kickoff prices for CLV and prediction benchmarking.
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
Can I calculate CLV with TheStatsAPI?
Yes. Use opening and last-seen odds from supported matches and compare them with your model or entry prices.
Which bookmaker should I use for CLV?
Pinnacle is often used as the sharp benchmark. Bet365 can also be useful when evaluating performance against retail prices.
Does TheStatsAPI include match outcomes too?
Yes. Match results, stats, player data, team data, and xG are available through related football endpoints.
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.