For the complete documentation index, see llms.txt. This page is also available as Markdown.

Live Predictions

What does the include do?

The livepredictions include returns a live-updating full-time result probability (Home/Away/Draw) for a fixture, recalculated roughly every minute while the match is in play. This is part of the Predictions Advanced tier, on top of everything in Predictions Basic.

Advanced tier only. Live Predictions is not available on the Predictions Basic add-on. See pricing for details.

Why use Live Predictions?

  • Live match centres: Show how a team's win probability shifts minute by minute as the match unfolds

  • In-play betting products: Track how in-game events (goals, cards) move the probability model in near real time

  • Momentum visualisation: Chart the home/away/draw lines across the match to show swings after key moments

Requesting Live Predictions

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

Only populates for fixtures currently in play. Requesting this include on a fixture that hasn't started or has already finished returns an empty array, not an error.

Response structure

{
  "data": {
    "id": 19674674,
    "name": "Shanghai Port vs Dalian Yingbo",
    "state_id": 2,
    "livepredictions": [
      {
        "id": 1762829,
        "fixture_id": 19674674,
        "period_id": 7048835,
        "minute": 1,
        "predictions": {
          "home": 50.89,
          "away": 25.63,
          "draw": 23.48
        },
        "type_id": 237
      },
      {
        "id": 1763608,
        "fixture_id": 19674674,
        "period_id": 7048835,
        "minute": 33,
        "predictions": {
          "home": 22.29,
          "away": 52.32,
          "draw": 25.39
        },
        "type_id": 237
      }
    ]
  }
}

Field descriptions

Field
Type
Description

id

integer

Unique identifier for this prediction snapshot

fixture_id

integer

The fixture this prediction belongs to

period_id

integer

The period (half) this snapshot was calculated in

minute

integer

The match minute this snapshot represents

predictions.home

float

Home win probability, as a percentage

predictions.away

float

Away win probability, as a percentage

predictions.draw

float

Draw probability, as a percentage

type_id

integer

Currently always 237 (full-time result), the only Live Predictions type available at launch

Only one prediction type (type_id: 237, full-time result) is available in Live Predictions at launch.

Example: tracking probability swings

Best practices

  1. Poll sparingly. Predictions update roughly once per minute, polling faster than that won't return new data and wastes requests.

  2. Handle the empty-array case. Always check livepredictions.length before assuming data is present, pre-match and finished fixtures return an empty array, not an error.

  3. Pair with include=events to correlate probability swings with specific match events (goals, red cards) for commentary or analysis features.

  • Predictions - the main Predictions Basic tier (pre-match probabilities, value bets)

  • Livescores - find fixtures currently in play to test this include against

Summary

The livepredictions include is an Advanced-tier-only feature returning minute-by-minute full-time result probability during live matches. Only one prediction type (type_id: 237) is available at launch, with more planned. It returns an empty array outside of live match windows, not an error.

Last updated

Was this helpful?