Status: OddsDirect is in development and not live yet. This page explains the subject and what the API is being built to do. Endpoints, response formats and limits will be published in the docs when the beta opens.
Football betting markets explained
Football has the deepest market list of any sport. These are the main families you will meet in any football odds feed:
| Market | What it settles on | Example price* |
|---|---|---|
| Match result (1X2) | Home / draw / away after 90 minutes | Home 2.10, Draw 3.40, Away 3.60 |
| Double chance | Two of the three results, e.g. home or draw | 1X 1.30 |
| Draw no bet | Stake refunded on a draw | Home 1.55 |
| Total goals | Over / under a line such as 2.5 | Over 2.5 1.90 |
| Both teams to score | Yes / no | Yes 1.75 |
| Asian handicap | Handicap on one team, half / whole / quarter lines | Home −0.5 2.10 |
| Correct score | Exact final score | 1-0 7.50 |
| Half-time / full-time | Result at both half-time and full-time | Home/Home 3.25 |
| Corners and cards | Totals and handicaps on corners or bookings | Over 9.5 corners 1.85 |
| Alternative lines | The same over/under market at extra lines, for goals, corners, cards, shots, free kicks, offsides and more | Shots over 22.5 1.90 Free kicks over 24.5 1.85 Offsides over 3.5 1.95 |
| Player markets | Goalscorers, shots, shots on target, cards, assists, fouls | Anytime scorer 3.00 |
*Example prices to illustrate the format, not live data.
Pre-match vs in-play football odds
Pre-match prices are available days before kick-off and move with team news, lineups and money. In-play prices start at kick-off and move with every event in the match. In-play markets suspend around goals, penalties and VAR checks. See Live Odds API for how to handle that.
Using football odds in a model
A common workflow is to turn prices into probabilities, remove the bookmaker margin and compare the result with your own model:
def implied(odds: list[float]) -> list[float]:
"""Implied probability of each outcome from decimal odds."""
return [1 / o for o in odds]
def overround(odds: list[float]) -> float:
"""Bookmaker margin: how far the implied probabilities sum above 100%."""
return sum(implied(odds)) - 1
def fair_odds(odds: list[float]) -> list[float]:
"""Remove the margin proportionally to get 'fair' (no-vig) odds."""
total = sum(implied(odds))
return [round(total / (1 / o), 3) for o in odds]
home_draw_away = [2.10, 3.40, 3.60] # example prices, not live data
print(f"margin: {overround(home_draw_away):.2%}") # margin: 4.81%
print(fair_odds(home_draw_away)) # [2.201, 3.563, 3.773]More examples in the Python guide.
Football odds in OddsDirect
Football is a core focus for OddsDirect: pre-match and in-play bet365 odds, the markets listed above, and player markets. League coverage and identifiers will be listed in the docs at beta launch.
Frequently asked questions
Which football markets will OddsDirect include?
The aim is to cover the markets bet365 lists for a fixture, pre-match and in-play, including player markets. The exact list will be published in the docs at beta launch.
What does 1X2 mean?
1X2 is the full-time match result: 1 is a home win, X a draw and 2 an away win. It is settled on the score after 90 minutes plus stoppage time, not extra time or penalties.
What is an Asian handicap?
A handicap applied to one team to remove the draw or balance a mismatch. Whole and half lines (−1, −0.5) settle as win or lose, or are refunded on an exact whole-line result; quarter lines (−0.75) split the stake across the two neighbouring lines.
Is the football odds API free?
OddsDirect will be free during the beta. What it costs after the beta has not been announced.