Saudi Pro League Odds API

Quick start: Saudi Pro League 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)


# tournamentId filters /v4/fixtures and lifts the 10 day range cap, so a
# whole month arrives in one call. It also cuts the payload about 20x.
fixtures = get("fixtures", {
    "tournamentId": 955,
    "from": "2026-09-09",
    "to": "2026-10-09",
}) or []
print(len(fixtures), "Saudi Pro League fixtures")

# 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:52 UTC. First line of output: 15 Saudi Pro League fixtures