nerd

Tournament-wide odds list (WC2026)

Latest odds snapshot per (match, sportsbook, market, participant) for every match in a tournament, grouped per match. tournament is required (wc2026 today). Returns 200 with matches: [] when no odds exist yet, so it self-fills as books open their markets. Response object keys: tournament, matches[] (match_id, kickoff, status, home, away, odds[]), generated_at. Each odds[] entry carries sportsbook, market, line (a market-shaped object), and fetched_at. 60-second Redis cache.

line.price_format (american | decimal) states which number system line.price is in. The two are stored in one column with no per-row flag, so a consumer reading price alone had to guess: a whole-number decimal such as 2 or 19 is indistinguishable from an American +2 / +19 by inspection, and 900 decimal rows sit at |price| >= 100 where magnitude cannot separate them either. The field is a FORMAT, never a provider. Edge plan or higher: odds access starts at Edge; Free / Solo / Trio receive a 403 naming the tier and linking the docs and pricing pages.

get/v1/odds

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/odds
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

tournament'wc2026' required

Tournament key. Required; wc2026 today.

datestring date

Filter to a single UTC calendar day (YYYY-MM-DD): kickoffs at or after 00:00Z that date and before 00:00Z the next. The exact window applied is echoed in meta.date_window.

tzstring
Example:America/New_York

Optional IANA time zone name (e.g. America/Mexico_City). ?date= then selects the local calendar day in that zone. Offsets such as -05:00 are rejected with 400. Example: ?tournament=wc2026&date=2026-06-11&tz=America/Mexico_City.

marketstring

Filter to one market (moneyline, handicap, total, ...). Omit for all.

Response

ok

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.