Live Predictions (beta)

📦 Add-on Required

Live Predictions requires the Predictions add-on
Available with all base plans. View pricing →

Live predictions give you a per-minute probability snapshot of the fulltime result for any live match. A new record is written each match minute, so you can track how the predicted outcome shifts in real time as the game unfolds.

Please note that this feature is currently still in beta

How it works

The model is powered by Octosport and requires sufficient historical statistics coverage to run. Availability is determined per fixture - not per league. A fixture typically becomes live-predictable within the first 10 minutes of kick-off. When it does, the model back-fills predictions for all previous minutes in that period.

Per match minute, one LivePrediction record is exposed, containing the home, away and draw probabilities.

Checking availability

Before requesting live predictions for a fixture, check whether it is live-predictable using the LIVE_PREDICTION_STATUS metadata type:

https://api.sportmonks.com/v3/football/fixtures/{fixture_id}
?include=metadata.type&api_token=YOUR_TOKEN

"metadata": [
  {
    "id": 9561219,
    "metadatable_id": 19656849,
    "type_id": 117442,
    "value_type": "object",
    "values": {
      "live_predictable": true
    },
    "type": {
      "id": 117442,
      "name": "Live Prediction Status",
      "code": "live-prediction-status",
      "developer_name": "LIVE_PREDICTION_STATUS",
      "model_type": "metadata",
      "stat_group": ""
    }
  }
]

live_predictable: true means live predictions are or will become available for this fixture. live_predictable: false means the model cannot generate predictions for this fixture and no records will be written. This follows the same pattern as PREDICTION_STATUS for regular predictions and PRESSURE_STATUS for the Pressure Index.

Retrieving live predictions

All live fixtures

https://api.sportmonks.com/v3/football/predictions/live/probabilities
?api_token=YOUR_TOKEN

Single fixture

https://api.sportmonks.com/v3/football/predictions/live/probabilities/fixtures/{fixture_id}
?api_token=YOUR_TOKEN

As a fixture include

Live predictions are also accessible as a nested include directly on a fixture:

https://api.sportmonks.com/v3/football/fixtures/{fixture_id}
?include=livePredictions&api_token=YOUR_TOKEN

Using includes

Three includes are available on LivePrediction records: fixture, period, and type.

https://api.sportmonks.com/v3/football/predictions/live/probabilities/fixtures/19656849
?include=fixture;period;type&api_token=YOUR_TOKEN

{
  "data": [
    {
      "id": 181,
      "fixture_id": 19656849,
      "period_id": 6965194,
      "minute": 1,
      "predictions": {
        "home": 52.08,
        "away": 25.76,
        "draw": 22.15
      },
      "type_id": 237,
      "period": {
        "id": 6965194,
        "fixture_id": 19656849,
        "type_id": 1,
        "started": 1779096745,
        "ended": 1779099528,
        "counts_from": 0,
        "ticking": false,
        "sort_order": 1,
        "description": "1st-half",
        "time_added": 2,
        "period_length": 45,
        "minutes": 46,
        "seconds": 23,
        "has_timer": false
      },
      "fixture": {
        "id": 19656849,
        "sport_id": 1,
        "league_id": 1490,
        "season_id": 27065,
        "name": "South Melbourne vs Caroline Springs George Cross FC",
        "starting_at": "2026-05-18 09:30:00"
      },
      "type": {
        "id": 237,
        "name": "Fulltime Result Probability",
        "code": "fulltime-result-probability",
        "developer_name": "FULLTIME_RESULT_PROBABILITY",
        "model_type": "prediction",
        "stat_group": null
      }
    }
  ]
}

Coverage

Live prediction coverage follows the same leagues as the regular Predictions add-on. For a full breakdown of which leagues and competitions are covered, see the Data Features per League reference.

Please check the LIVE_PREDICTION_STATUS metadata to exactly spot the availability per fixture.