Football Odds API

Quick start: Football fixtures and prices

Copy it as it stands. It was run against the live API before this page rendered.

import datetime as dt
import time

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.oddspapi.io/v4"


def get(path, params):
    """The key is the query parameter apiKey, never a header.
    Read the status code first: a 429 body is valid JSON too."""
    query = dict(params, apiKey=API_KEY)
    for attempt in range(3):
        response = requests.get(f"{BASE_URL}/{path}", params=query, timeout=180)
        if response.status_code == 429:
            time.sleep(5 * (attempt + 1))
            continue
        if response.status_code == 404:
            return None
        response.raise_for_status()
        return response.json()
    raise RuntimeError("rate limited on /" + path)


# Fixtures for Football. sportId 10 is the only filter here,
# so the from and to range has to stay under 10 days. Adding tournamentId
# lifts that cap.
fixtures = get("fixtures", {
    "sportId": 10,
    "from": "2026-09-09",
    "to": "2026-09-18",
}) or []
print(len(fixtures), "fixtures in the window")

# The same bet ships under more than one market id on several sports, so
# resolve the result market from /v4/markets by name and read every id that
# maps to it. Reading one id drops part of the board.
MAIN_MARKET_IDS = ["101", "10728"]

# hasOdds is a flag, not a depth signal, and it is false on every finished
# fixture. Boards open on their own clock, so the fixtures nearest kick-off
# carry the prices, and a fixture already in play often has the result market
# suspended. Read the ones still ahead of us, soonest first.
now = dt.datetime.now(dt.timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.000Z")
upcoming = sorted(
    (f for f in fixtures if f["hasOdds"] and f["startTime"] > now),
    key=lambda f: f["startTime"],
)
for fixture in upcoming[:10]:
    odds = get("odds", {
        "fixtureId": fixture["fixtureId"],
        "bookmakers": "pinnacle,bet365,draftkings",
    })
    boards = (odds or {}).get("bookmakerOdds") or {}
    printed = False
    for slug, board in boards.items():
        for market_id in MAIN_MARKET_IDS:
            market = board["markets"].get(market_id)
            if not market:
                continue
            # players is keyed "0" on a match market. On a player prop it is
            # keyed by player id, so never hardcode "0" outside this case.
            prices = {
                outcome_id: leg["players"]["0"]["price"]
                for outcome_id, leg in market["outcomes"].items()
                if leg["players"]["0"]["active"]
            }
            if prices:
                print(fixture["participant1Name"], "v",
                      fixture["participant2Name"], slug, market_id, prices)
                printed = True
    if printed:
        break
    time.sleep(1.0)

Run against the live API at 2026-09-09 21:50 UTC. First line of output: 5936 fixtures in the window