Sports Odds API Coverage

Quick start: sports and tournaments

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)


# Every sport we carry, with the id the rest of the API keys on.
sports = get("sports", {})
print(len(sports), "sports")

# Tournaments for one sport. futureFixtures above zero proves a circuit is
# live. futureFixtures of zero proves nothing on its own, so confirm a
# circuit from /fixtures grouped on tournamentId.
tournaments = get("tournaments", {"sportId": 10})
live = [t for t in tournaments if t["futureFixtures"] > 0]
live.sort(key=lambda t: -t["futureFixtures"])
for tournament in live[:5]:
    print(tournament["tournamentId"], tournament["tournamentName"],
          tournament["categoryName"], tournament["futureFixtures"])

Run against the live API at 2026-09-09 21:53 UTC. First line of output: 69 sports