GET Live Probabilities by Fixture ID

📦 Add-on Required
Live Probabilities requires the Predictions add-on (EUR 9-99).
Available with all base plans. View pricing →

This endpoint returns all live probabilities for a single fixture. Use it when you want per-minute win/draw/loss forecasts for a specific live match rather than pulling all probabilities across your subscription.

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

{
  "data": [
    {
      "id": 181,
      "fixture_id": 19656849,
      "period_id": 6965194,
      "minute": 1,
      "predictions": {
        "home": 52.08,
        "away": 25.76,
        "draw": 22.15
      },
      "type_id": 237
    },
    {
      "id": 182,
      "fixture_id": 19656849,
      "period_id": 6965194,
      "minute": 2,
      "predictions": {
        "home": 52.84,
        "away": 25.64,
        "draw": 21.52
      },
      "type_id": 237
    },
    {
      "id": 183,
      "fixture_id": 19656849,
      "period_id": 6965194,
      "minute": 3,
      "predictions": {
        "home": 28.02,
        "away": 51.05,
        "draw": 20.92
      },
      "type_id": 237
    }
  ]
}

Name

Required?

Description

api_token

YES

Your unique API token. Alternatively, provide it in the request header. Ex. ?api_token=YOUR_TOKEN

include

Enrich the response with related data. Ex. &include=fixture;period;type

filters

Filter the response on related entities. See the Static and Dynamic Filter tabs for available options.

locale

Translate name fields into your selected language. See the translations page.

Filters

More information on how to use filters can be found in the filtering tutorial. To check all available filters for this entity:

https://api.sportmonks.com/v3/my/filters/entity?api_token=YOUR_TOKEN

Pagination

YES - cursor-based. Each response includes a pagination object:

"pagination": {
  "count": 25,
  "per_page": 25,
  "current_page": 1,
  "next_cursor": "WzEsMixbMTk3MTAxMDBdLFtbInNwb3J0cy5...",
  "has_more": true
}

Pass the next_cursor value as a cursor parameter in your next request. Keep paginating until has_more is false.

Parameters

Parameter

Required

Description

Example

order

Returns live probabilities ordered by id (asc or desc). Defaults to asc.

&order=desc

per_page

The number of results to return per page (max 50). Defaults to 25.

&per_page=50

cursor

The cursor value from next_cursor in the previous response. Omit on the first call.

&cursor=WzEsMixbMTk3MTAxMD...

Include depth

You can use a total of 1 nested include on this endpoint.

Include options

fixture period type

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

Checking availability

To check whether a fixture supports live predictions before requesting them, use the metadata include on the fixture and look for the LIVE_PREDICTION_STATUS type:

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

The values.live_predictable field returns true if live predictions are available for that fixture.

{
  "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": ""
      }
    }
  ]
}

Postman

We also offer detailed Postman documentation with examples and a complete, up-to-date version of all our endpoints. Below is a button to fork or import the collection.

Code Example

{% tabs %} {% tab title="" %}

const fixtureId = 19656849;
const response = await fetch(
  `https://api.sportmonks.com/v3/football/predictions/live/probabilities/fixtures/${fixtureId}?api_token=YOUR_TOKEN`
);
const data = await response.json();
console.log(data);

<?php

$fixtureId = 19656849;
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.sportmonks.com/v3/football/predictions/live/probabilities/fixtures/{$fixtureId}?api_token=YOUR_TOKEN",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import http.client

fixture_id = 19656849
conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", f"/v3/football/predictions/live/probabilities/fixtures/{fixture_id}?api_token=YOUR_TOKEN", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

package main

import (
  "fmt"
  "io/ioutil"
  "net/http"
)

func main() {
  fixtureId := "19656849"
  url := "https://api.sportmonks.com/v3/football/predictions/live/probabilities/fixtures/" + fixtureId + "?api_token=YOUR_TOKEN"

  client := &http.Client{}
  req, err := http.NewRequest("GET", url, nil)
  if err != nil {
    fmt.Println(err)
    return
  }

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}