Odds by fixture, bookmaker and market id

Odds by fixture and bookmaker id

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):

Request

https://soccer.sportmonks.com/api/v2.0/odds/fixture/17361236/bookmaker/2?api_token={API_TOKEN}

Response

{
    "data": [
        {
            "id": 1,
            "name": "3Way Result",
            "suspended": false,
            "bookmaker": {
                "data": [
                    {
                        "id": 2,
                        "name": "bet365",
                        "odds": {
                            "data": [
                                {
                                    "label": "1",
                                    "value": "2.90",
                                    "extra": null,
                                    "probability": "34.48%",
                                    "dp3": "2.9000",
                                    "american": 190,
                                    "factional": null,
                                    "handicap": null,
                                    "total": null,
                                    "winning": null,
                                    "stop": false,
                                    "bookmaker_event_id": 94629640,
                                    "last_update": {
                                        "date": "2020-10-28 10:37:17.587467",
                                        "timezone_type": 3,
                                        "timezone": "UTC"
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "3.50",
                                    "extra": null,
                                    "probability": "28.57%",
                                    "dp3": "3.5000",
                                    "american": 250,
                                    "factional": null,
                                    "handicap": null,
                                    "total": null,
                                    "winning": null,
                                    "stop": false,
                                    "bookmaker_event_id": 94629640,
                                    "last_update": {
                                        "date": "2020-10-28 10:37:17.587478",
                                        "timezone_type": 3,
                                        "timezone": "UTC"
                                    }
                                },
                                {
                                    "label": "2",
                                    "value": "2.35",
                                    "extra": null,
                                    "probability": "42.55%",
                                    "dp3": "2.3500",
                                    "american": 135,
                                    "factional": null,
                                    "handicap": null,
                                    "total": null,
                                    "winning": null,
                                    "stop": false,
                                    "bookmaker_event_id": 94629640,
                                    "last_update": {
                                        "date": "2020-10-28 10:37:17.587487",
                                        "timezone_type": 3,
                                        "timezone": "UTC"
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        },

As you can see, it gives you all the markets from bet365. However, you can also request one market from all the bookmakers.

Odds by Fixture and Market id

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).

Request

https://soccer.sportmonks.com/api/v2.0/odds/fixture/17361236/market/1?api_token={API_TOKEN}

Response

{
    "data": [
        {
            "id": 1,
            "name": "3Way Result",
            "suspended": true,
            "bookmaker": {
                "data": [
                    {
                        "id": 271057009,
                        "name": "CloudBet",
                        "odds": {
                            "data": [
                                {
                                    "label": "1",
                                    "value": "2.99",
                                    "probability": "33.44%",
                                    "dp3": "2.990",
                                    "american": 199,
                                    "factional": null,
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": "2020-10-28 14:34:34.000000",
                                        "timezone_type": 3,
                                        "timezone": "UTC"
                                    }
                                },
                                {
                                    "label": "X",
                                    "value": "3.46",
                                    "probability": "28.9%",
                                    "dp3": "3.459",
                                    "american": 246,
                                    "factional": null,
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": "2020-10-28 14:34:34.000000",
                                        "timezone_type": 3,
                                        "timezone": "UTC"
                                    }
                                },
                                {
                                    "label": "2",
                                    "value": "2.51",
                                    "probability": "39.84%",
                                    "dp3": "2.510",
                                    "american": 150,
                                    "factional": null,
                                    "winning": null,
                                    "handicap": null,
                                    "total": null,
                                    "bookmaker_event_id": null,
                                    "last_update": {
                                        "date": "2020-10-28 14:34:34.000000",
                                        "timezone_type": 3,
                                        "timezone": "UTC"
                                    }
                                }
                            ]
                        }
                    }, 

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.

Odds by fixture id

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:

https://soccer.sportmonks.com/api/v2.0/odds/fixture/17361236?api_token={API_TOKEN}

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.