GET Live Probabilities

📦 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 currently available within your subscription. Live probabilities are generated per minute during the live period of a match and reflect real-time win/draw/loss forecasts as the game progresses.

https://api.sportmonks.com/v3/football/predictions/live/probabilities

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

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

const response = await fetch(
  "https://api.sportmonks.com/v3/football/predictions/live/probabilities
?api_token=YOUR_TOKEN"
);
const data = await response.json();
console.log(data);

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.sportmonks.com/v3/football/predictions/live/probabilities?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

conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/football/predictions/live/probabilities
?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() {
  url := "https://api.sportmonks.com/v3/football/predictions/live/probabilities?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))
}