Value Bet

The Value Bet model processes thousands of historical odds data and market trends to find the best value opportunities. In other words, it compares bookmakers' odds with each other and then gives you the best value bookmaker.

Once the opening odds are available, the value detection algorithm runs every 10 minutes up to the beginning of the match.

Please note that our algorithm detects value bets based on all available odds in combination with the fair odd calculated by the value bet algorithm. Therefore, not every match has a value bet available.

An overview of all the options to request value bets:

  • GET Value Bets: returns all value bets available within your subscription.

  • GET Value Bets by Fixture ID: returns all the value bets available for your requested fixture id.

For all the value bets endpoints the base URL is the same:

https://api.sportmonks.com/v3/football/predictions/value-bets

Per endpoint, the rest of the URL requires additional information. We will explain this per endpoint.

Requesting value bets

GET All Value Bets

Returns all value bets available within your subscription. You can best use this endpoint if youโ€™re interested in all the value bets available in your subscription. All you have to do is authorize the request with your API token. Check our authentication section for more info.

https://api.sportmonks.com/v3/football/predictions/value-bets?api_token=YOUR_TOKEN
Response
{
  "data": [
    {
      "id": 2800275,
      "fixture_id": 17952906,
      "predictions": {
        "bet": "1",
        "bookmaker": "williamhill",
        "odd": 1.55,
        "is_value": false,
        "stake": 1.26,
        "fair_odd": 1.52
      },
      "type_id": 33
    },
    {
      "id": 2740193,
      "fixture_id": 17948781,
      "predictions": {
        "bet": "1",
        "bookmaker": "betcris",
        "odd": 3.65,
        "is_value": false,
        "stake": 0.54,
        "fair_odd": 3.42
      },
      "type_id": 33
    },
    //And more

Letโ€™s evaluate the response:

  • bet: 1 = home, x = draw, 2 = away

  • bookmaker: The name of the bookmaker with the best odd

  • odd: The odd provided by the bookmaker

  • is_value: Indicates if the value bet is still available

  • stake: The stake helps manage the risk that the model would take in the bet. The risk is measured with the volatility of the profit and loss of the value bet strategy. The stake is calculated to have an average risk of one unit.

  • fair_odd: Our algorithm allows you to find the fair odd of a value. The fair odd is useful to play against bookmakers that are not listed in Sportmonks. Any odd above the fair odd can be considered as value.

GET Value Bets by Fixture ID

Not interested in all the value bets? Just looking for the value bets of a single fixture? Fear not. You can use the value bets by fixture id endpoint. Add the fixture id youโ€™re interested in:

https://api.sportmonks.com/v3/football/predictions/value-bets/fixtures/{fixture_id}

For example, if youโ€™re interested in the value bets for Dundee vs Celtic (fixture id: 18136955).

https://api.sportmonks.com/v3/football/predictions/value-bets/fixtures/18136955?api_token=YOUR_TOKEN
Response
{
  "data": [
    {
      "id": 135602,
      "fixture_id": 18136955,
      "predictions": {
        "bet": "2",
        "fair_odd": 1.33,
        "odd": 1.35,
        "stake": 1.66,
        "is_value": false
      },
      "type_id": 33
    }
  ],

Adding useful information

As youโ€™ve learnt in the includes tutorial, you can enrich your request with includes. This section will discuss some of the most common requests used on the value bet endpoints.

First of all, you can find a list of all available includes on the endpoint pages. For the value bets, there are only two includes available:

  • type: includes the type.

  • fixture: includes the fixture information.

For example, if youโ€™re interested in the value bets for Dundee vs Celtic (fixture id: 18136955) with the type and fixture info.

https://api.sportmonks.com/v3/football/predictions/value-bets/fixtures/18136955?api_token=YOUR_TOKEN&include=type;fixture
Response
{
  "data": [
    {
      "id": 135602,
      "fixture_id": 18136955,
      "predictions": {
        "bet": "2",
        "fair_odd": 1.33,
        "odd": 1.35,
        "stake": 1.66,
        "is_value": false
      },
      "type_id": 33,
      "type": {
        "id": 33,
        "name": "Valuebet",
        "code": "valuebet",
        "developer_name": "VALUEBET",
        "model_type": "prediction",
        "stat_group": null
      },
      "fixture": {
        "id": 18136955,
        "sport_id": 1,
        "league_id": 501,
        "season_id": 18369,
        "stage_id": 77453684,
        "group_id": null,
        "aggregate_id": null,
        "round_id": 247443,
        "state_id": 5,
        "venue_id": 284597,
        "name": "Dundee vs Celtic",
        "starting_at": "2021-11-07 12:00:00",
        "result_info": "Celtic won after full-time.",
        "leg": "1/1",
        "details": null,
        "length": 90,
        "placeholder": false,
        "last_processed_at": "2023-03-02 17:54:33",
        "has_odds": true,
        "starting_at_timestamp": 1636286400
      }
    }
  ],

Selecting and filtering

In our filtering tutorial 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 value bets by default. We can imagine youโ€™re not interested in all the data the API returns.

Youโ€™re interested in the value bets for Dundee vs Celtic (fixture id: 18136955) with the type and fixture info, but only the names. This results in the below request and response:

https://api.sportmonks.com/v3/football/predictions/value-bets/fixtures/18136955?api_token=YOUR_TOKEN&include=type:name;fixture:name
Response
{
  "data": [
    {
      "id": 135602,
      "fixture_id": 18136955,
      "predictions": {
        "bet": "2",
        "fair_odd": 1.33,
        "odd": 1.35,
        "stake": 1.66,
        "is_value": false
      },
      "type_id": 33,
      "type": {
        "id": 33,
        "name": "Valuebet"
      },
      "fixture": {
        "id": 18136955,
        "sport_id": 1,
        "round_id": 247443,
        "stage_id": 77453684,
        "group_id": null,
        "aggregate_id": null,
        "league_id": 501,
        "season_id": 18369,
        "venue_id": 284597,
        "state_id": 5,
        "name": "Dundee vs Celtic",
        "starting_at_timestamp": null
      }
    }
  ],

Check our filtering tutorial for more tips and tricks.

Last updated