hasOdds

In this tutorial, we’re going to discuss the HasOdds filter. A field called has_odds has been implemented on Fixture entities, marking whether a Fixture has odds available in our database.

What does the filter do?

The filter does exactly what you think it does. It shows if the fixture has odds.

It can be applied to all fixture entities.

How to apply the filter?

You can apply the filter as follows:

&filters=havingOdds

What if I want the opposite result?

You can also switch the value of the boolean to check for fixtures that don’t have odds. Use &filters=havingOdds:false to get the exact opposite result. The fixtures without odds will be included in the response you receive from our API.

Why would I use the hasOdds filter?

You can separate the fixtures that do and don’t have odds. You don’t have to create your own filter and keep refreshing. You can now use one (or two) requests to separate the fixtures and get the ones you need.

Make the requests and evaluate the response

So you can filter both ways. You can find all fixtures with odds, or you can find all fixtures without odds. Let’s look at an example of how to do this exactly.

https://api.sportmonks.com/v3/football/livescores/inplay?api_token=YOUR_TOKEN

Now we are simply adding &filters=havingOdds, and we will receive all live fixtures with odds.

Request

https://api.sportmonks.com/v3/football/livescores/inplay?api_token=YOUR_TOKEN&filters=havingOdds

Response

[
    {
      "id": 18784100,
      "sport_id": 1,
      "league_id": 393,
      "season_id": 21151,
      "stage_id": 77461810,
      "group_id": null,
      "aggregate_id": null,
      "round_id": 300619,
      "state_id": 1,
      "venue_id": 271664,
      "name": "Maqtaaral vs Astana",
      "starting_at": "2023-05-10 12:00:00",
      "result_info": null,
      "leg": "1/1",
      "details": null,
      "length": 90,
      "placeholder": false,
      "has_odds": true,
      "starting_at_timestamp": 1683720000
    },
    {
      "id": 18804175,
      "sport_id": 1,
      "league_id": 396,
      "season_id": 21288,
      "stage_id": 77462384,
      "group_id": null,
      "aggregate_id": null,
      "round_id": 302940,
      "state_id": 1,
      "venue_id": 7467,
      "name": "Arys vs Sport Academy Kairat",
      "starting_at": "2023-05-10 12:00:00",
      "result_info": null,
      "leg": "1/1",
      "details": null,
      "length": 90,
      "placeholder": false,
      "has_odds": true,
      "starting_at_timestamp": 1683720000
    },
    {
      "id": 18825943,
      "sport_id": 1,
      "league_id": 1422,
      "season_id": 19970,
      "stage_id": 77462770,
      "group_id": 248829,
      "aggregate_id": null,
      "round_id": 305750,
      "state_id": 3,
      "venue_id": 2690,
      "name": "Stuttgart U19 vs Hamburger SV U19",
      "starting_at": "2023-05-10 11:00:00",
      "result_info": null,
      "leg": "1/1",
      "details": null,
      "length": 90,
      "placeholder": false,
      "has_odds": true,
      "starting_at_timestamp": 1683716400

Let’s find out about the opposite. The request is done at exactly the same time, but the response shows different matches.

Request

https://api.sportmonks.com/v3/football/livescores/inplay?api_token=YOUR_TOKEN&filters=havingOdds:false

Response

{
    "data": [
        {
            "id": 18806840,
            "sport_id": 1,
            "league_id": 1953,
            "season_id": 21290,
            "stage_id": 77462393,
            "group_id": null,
            "aggregate_id": null,
            "round_id": 303231,
            "state_id": 1,
            "venue_id": 145072,
            "name": "West NTC W vs Murdoch Uni Melville W",
            "starting_at": "2023-05-10 12:00:00",
            "result_info": null,
            "leg": "1/1",
            "details": null,
            "length": 90,
            "placeholder": false,
            "has_odds": false,
            "starting_at_timestamp": 1683720000
        },
        {
            "id": 18804793,
            "sport_id": 1,
            "league_id": 848,
            "season_id": 20373,
            "stage_id": 77459481,
            "group_id": null,
            "aggregate_id": null,
            "round_id": null,
            "state_id": 1,
            "venue_id": null,
            "name": "Police vs Sofapaka",
            "starting_at": "2023-05-10 12:00:00",
            "result_info": null,
            "leg": "1/1",
            "details": null,
            "length": 90,
            "placeholder": false,
            "has_odds": false,
            "starting_at_timestamp": 1683720000
        },
        {
            "id": 18601096,
            "sport_id": 1,
            "league_id": 178,
            "season_id": 20115,
            "stage_id": 77458867,
            "group_id": null,
            "aggregate_id": null,
            "round_id": 282013,
            "state_id": 1,
            "venue_id": 339164,
            "name": "BKMA II vs Gandzasar",
            "starting_at": "2023-05-10 12:00:00",
            "result_info": null,
            "leg": "1/1",
            "details": null,
            "length": 90,
            "placeholder": false,
            "has_odds": false,
            "starting_at_timestamp": 1683720000
        },
```