Odds are one of our API's most used features. With this data feature, you can build an odds portal and a match page with odds. We offer various ways of requesting odds.
The possibilities are:
But first, let's explain what bookmakers and markets are.
A bookmaker is a betting company that gives you the option to bet on a match’s particular outcome. The market is the type of betting system itself. There are various markets, but the most well-known one is the 3-way result (home team wins, draw, visitor team wins).
We at SportMonks offer you a large number of markets and bookmakers for you to choose from.
You can request all the bookmakers' ids via our bookmakers endpoint. This endpoint is very useful for administrative purposes to check and structure the bookmakers’ availability.
Besides that, you can request all the market ids via our markets endpoint. The markets endpoint will help you set up the Odds properly on your website or application. This endpoint is very useful for administrative purposes to check and structure market availability.
Here's an overview of all the different odds we will discuss:
Live odds: these are the odds for live games. We only offer bet365 and all their markets for live odds. Please note that you can only use the live odds when the fixture is in-play.
Pre-match odds: these are odds before a fixture. You can best use this if you want to show the odds before a match starts.
FlatOdds: this is used as an include on our livescores/fixtures endpoint. It allows you to filter on a specific bookmaker and/or market id.
OddComparison: the benefit of the oddComparison include is that it contains more bookmakers, making this the best option if you want to make a comparison application between all the bookmakers and the odds they offer.
You can also use odds as an include on the fixture endpoints or livescores endpoints. When you do this, you’re able to filter on multiple bookmakers and markets because the fixture endpoint has those parameters.
Therefore, if you want to request odds from various bookmakers or markets, we suggest using flatOdds as an include.
For example, the 3-way result market (#1) from bet365 (#2) of all the fixtures played on 2020-08-02
Last but not least, you can also use oddComparison as an include. The main difference between flatOdds and oddComparison is that flatOdds are updated more frequently.
The benefit of the oddComparison include is that it contains more bookmakers. Therefore this is the best option if you want to make a comparison application between all the bookmakers and the odds they offer.
The odds by fixture and bookmaker id endpoint is recommended if you want to request the odds for one fixture and one bookmaker.
As you can see, you need to parse one fixture and one bookmaker id. The endpoint will return all the available markets of one bookmaker for one fixture. As mentioned previously, you can find the bookmakers ids via our bookmaker endpoint.
For example, the odds from bet365 (#2) for the fixture Juventus – Barcelona (17361236):
As you can see, it gives you all the markets from bet365. However, you can also request one market from all the bookmakers.
Let’s continue with this example. However, this time, you want to know the odds of the home, draw, away (3-way-result) market from all the bookmakers from the same fixture. You can use our odds by fixture and market id for this.
As you can see, you need to parse one fixture and one market id. The endpoint will return one market from all the available bookmakers for one fixture. You can find the market ids via our markets endpoint.
For example, the 3-way-result market (#1) for the fixture Juventus – Barcelona (17361236).
As you can see, the API returns all the odds of the requested market from different bookmakers. You can see Cloudbet and many more. This could be great if you want to compare all the bookmakers from one market.
Interested in the best odds for a market? We also offer a Value Bet model for this. More about the value bet can be found in our predictions tutorial.
Of course, it’s also possible to request all the odds markets from all the bookmakers. You can use our odds by fixture id endpoint for that:
Note that it’s not possible to filter on this endpoint. If you want to filter the odds, you should use the flatOdds include on one of our fixtures endpoints.
We also have live odds available. It’s good to note that we have all the markets but only from bet365 for live odds. Live odds can only be requested when the fixture is in-play. There are no live odds available before and after the fixture.
You can use our inplay odds by fixture id endpoint to get live odds of one fixture. However, you can also use inplayOddsas an include on one of our livescores endpoints.