GET Live Probabilities by Fixture ID

📦 Add-on Required Live Probabilities requires the Predictions Advanced tier. Not included in Predictions Basic. 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.

BAse URL

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

Example Response

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

Field Description

Field	Description	Type
id	The unique ID of this live prediction record	integer
fixture_id	The ID of the fixture this prediction belongs to	integer
period_id	The ID of the match period (e.g. first half, second half) this prediction was recorded in	integer
minute	The match minute at which this prediction was generated	integer
predictions	An object containing the home win, away win, and draw probabilities as percentages	object
type_id	The prediction type. For live probabilities, this is always 237 (Fulltime Result Probability)	integer

Query Parameters

Name	Required?	Description
api_token	YES	Your unique API token. Alternatively, provide it in the request header. Ex. ?api_token=YOUR_TOKEN
include	NO	Enrich the response with related data. Ex. &include=fixture;period;type
filters	NO	Filter the response on related entities. See the Static and Dynamic Filter tabs for available options.
locale	NO	Translate name fields into your selected language. See the translations page.

Static Filters

Static Filter	Available on Entity	Description	Example
N/A	N/A	Not available for this endpoint.	N/A

Dynamic Filters

Dynamic Filter	Available on Entity	Description	Example
predictionTypes	LivePrediction	Filter results to a specific prediction type ID, separated by a comma.	&filters=predictionTypes:237

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	No	Returns live probabilities ordered by id (asc or desc). Defaults to asc.	&order=desc
per_page	No	The number of results to return per page (max 50). Defaults to 25.	&per_page=50
cursor	No	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

JavaScript

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

<?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;

curl

curl --location 'https://api.sportmonks.com/v3/football/predictions/
live/probabilities/fixtures/19656849?api_token=YOUR_TOKEN

Python

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"))

Go

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))
}

See also

Regular Predictions

• GET Probabilities

• GET Probabilities by Fixture ID