Market benchmark

Closing Odds API for Football

Use latest stored pre-kickoff football odds as a benchmark for model validation and closing line value analysis.

Bet365, Pinnacle, Betfair Exchange, and Kambi coverage
1X2, BTTS, totals, corners, and Asian handicap markets
Opening and last-seen prices for supported matches
Related football data endpoints for fixtures, xG, teams, and players

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

Main field
last_seen
Best use
CLV and model benchmarking
Sharp benchmark
Pinnacle where available
Retail comparison
Bet365 where available

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
Endpoint

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.

football closing odds APIclosing line APIclosing price odds API
REST JSON
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" }
          }
        }
      }
    ]
  }
}
FAQ

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.

Pricing_Plans

Simple, Transparent Pricing

Every plan includes stats, odds, xG, history, and every documented endpoint.

Starter

$50/month

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
Most Popular

Growth

$129/month

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

$379/month

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
No odds, xG, or history add-ons
Cancel anytime
7-day free trial on all plans

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.