Skip to main content
Returns a snapshot of odds before kickoff, covering 63 market types including match result, handicap, over/under goals, corners, cards, correct score, and more (see the enum reference below for the full list); the odds source is bet365. You can query a single match by match_id, or query in bulk by league name. Typically used for odds displays on pre-match analysis pages, or as a data source for Asian handicap/over-under index analysis; updates are poll-based (updated_at), unlike Live Odds, which pushes updates every second. The two endpoints use different option label systems: pre-match uses Home/Draw/Away, while live odds uses 1/X/2 — be careful to distinguish them when integrating.

Endpoint

Parameters

Response fields (data: array)

The odds source is bet365 (i.e. the current constant value of the bookmaker field).The option label system differs from live odds: pre-match uses Home/Draw/Away (live odds uses 1/X/2).Localization note: when lang is a non-default language, code fields (main_market/market_code/option name) retain their original values, and parallel localized labels main_market_label/market_code_label/options[].name_label are added (not every value has localized text, and when there is no corresponding text this field is omitted, so clients must handle that gracefully); team names/league names (home/away/league) are not yet localized by lang.Handicap-based pre-match markets (Asian handicap/over-under/Goal Line/corner count/cards, etc.) embed the handicap value within the option itself, with a single market containing multiple handicap lines simultaneously: e.g. over/under has Over 2.5/Under 2.5/Over 1.5/Under 1.5…, and Asian handicap has Home -1.25/Away +1.25 (appearing in pairs, with the two sides’ handicap values being opposites of each other).

Enum reference

phase enum

Pre-match odds market directory

The table below lists the market directory by English market name, with a reference for its localized meaning; the market_code for a given market is the snake_case form of its English name (lowercase, non-alphanumeric characters collapsed to _), e.g.:
  • Match Winner → match_winner
  • Goals Over/Under → goals_over_under
  • Home/Away → home_away
  • 2nd Half Winner → 2nd_half_winner
Values may expand over time. There is no market-level handicap field. Markets marked with ⚠ are handicap-based markets: the option label embeds the handicap value, and a single market contains multiple handicap lines (over/under types like Over 2.5/Under 2.5/Over 3…; handicap types appear in pairs with the two sides’ values being opposites of each other, e.g. Home -0.25/Away +0.25). 1). Match result / double chance 2). Goal count 3). Goal-related (yes/no, first/last, player) 4). Corners / cards (⚠ all handicap-based markets, with the handicap value embedded in the option label): 5). Correct score

Request example

Response example

HTTP 200, semi-final England vs Argentina, 59 markets total; excerpt