Pre-match odds
Last updated
Last updated
In the previous sections, you’ve learnt about bookmakers and markets and how to retrieve them via our API. Now, let’s take a look at the odds from those bookmakers and markets.
It’s good to note that we’ve separated pre-match odds from live odds. Interested in live odds? Check our
An overview of all the options available to request pre-match odds:
GET All Odds: returns all the pre-match odds.
GET Odds by Fixture ID: returns the pre-match odds from your requested fixture id.
GET Odds by Fixture ID and Bookmaker ID: returns the pre-match odds filtered on bookmaker id from your requested fixture id.
GET Odds by Fixture ID and Market ID: returns the pre-match odds filtered on market id from your requested fixture id.
For all the pre-match odds endpoints the base URL is the same:
https://api.sportmonks.com/v3/football/odds/pre-match
Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.
The first option is to request all the odds available in our APIs. With this information, you can determine if the odds you’re interested in are available.
The URL to get all pre-match odds is the same as the base URL for pre-match odds. All you have to do is authorize the request with your API token. Check our for more info.
Let’s take a look together at the key values the API returns:
id: the unique id of the odd
fixture_id: the unique fixture id the odd is available for
market_id: the unique id of the market the odd belongs to
bookmaker_id: the unique id of the bookmaker who offers the odd
label: the label name of the odd
value: the odd value
name: the name of the odd
sort_order: n/a
market_description: the description of the market the odd belongs to
Now you’ve gathered an overview of the available pre-match odds. You can also retrieve the odds for only a specific fixture.
A lot of our customers are not interested in all odds, but only in odds of a specific fixture. This endpoint is perfectly suited for this. The only thing you’ve to do is parse the fixture_id you want the odds for:
https://api.sportmonks.com/v3/football/odds/pre-match/fixtures/{fixture_id}
For example, if you’re interested in the pre-match odds available for Celtic vs Rangers (fixture id: 18535517)
As you might have noticed in the previous example, requesting all the pre-match odds for a single fixture is quite a big response. Maybe you’re only interested in the odds of a specific fixture from a single bookmaker?
https://api.sportmonks.com/v3/football/odds/pre-match/fixtures/{fixture_id}/bookmakers/{bookmaker_id}
For example, if you’re interested in the pre-match odds from bet365 (id: 2) available for Celtic vs Rangers (fixture id: 18535517)
You can also request all the pre-match odds from a specific market and a specific fixture. The only thing you’ve to do is parse the fixture_id and market_id you want the odds for:
https://api.sportmonks.com/v3/football/odds/pre-match/fixtures/{fixture_id}/markets/{market_id}
For example, if you’re interested in the pre-match odds from the BTTS market (id: 14) available for Celtic vs Rangers (fixture id: 18535517)
market: includes the market information the oddd belongs to.
bookmaker: includes the bookmaker information of the bookmaker that offers the odd.
fixture: includes the fixture information the odds is available for.
For example, if you’re interested in the pre-match odds available for Celtic vs Rangers (fixture id: 18535517) with the name of the bookmakers, markets and fixture info.
You can add the &select= parameter followed by the fields you want. In our case: market_description,value. This results in the below request and response:
is perfectly suited for this. The only thing you’ve to do is parse the fixture_id and bookmaker_id you want the odds for:
As you’ve learnt in the you can enrich your request with includes. This section will discuss some of the most common requests used on the odds endpoints.
First of all, you can find a list of all available includes on the . For the odds, there are only 3 includes available:
In our you’ve learnt how to select specific fields or filter only on the data you’re interested in. Our API returns a set of data related to the odd by default. We can imagine you’re not interested in all the odds data the API returns. Let’s say you’re only interested in the market description and value.
We’re going to use the endpoint for this example.
Check our for more tips and tricks.