IN DEVELOPMENT · FREE DURING BETA

Football odds API for bet365 soccer prices

Every major football market explained, with a Python example for turning prices into fair probabilities, plus what OddsDirect is building for football.

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:

MarketWhat it settles onExample price*
Match result (1X2)Home / draw / away after 90 minutesHome 2.10, Draw 3.40, Away 3.60
Double chanceTwo of the three results, e.g. home or draw1X 1.30
Draw no betStake refunded on a drawHome 1.55
Total goalsOver / under a line such as 2.5Over 2.5 1.90
Both teams to scoreYes / noYes 1.75
Asian handicapHandicap on one team, half / whole / quarter linesHome −0.5 2.10
Correct scoreExact final score1-0 7.50
Half-time / full-timeResult at both half-time and full-timeHome/Home 3.25
Corners and cardsTotals and handicaps on corners or bookingsOver 9.5 corners 1.85
Alternative linesThe same over/under market at extra lines, for goals, corners, cards, shots, free kicks, offsides and moreShots over 22.5 1.90
Free kicks over 24.5 1.85
Offsides over 3.5 1.95
Player marketsGoalscorers, shots, shots on target, cards, assists, foulsAnytime 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:

remove the margin from a 1X2 marketpython
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.

Football endpoints and examples: coming soonReal request and response examples will be published 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.

Be first in line for a beta key

The API will be free during the beta. Keys go out in our Discord first.

Related