Probability By Fixture Id

  • Basic
  • Standard
  • Advanced
  • Custom

Introduction

By using this endpoint, you can get all predictions on markets like, Winner, Correct Score, Over/Under, BTTS and more for every individual Fixture. The Probabilities values are between 0 and 100, representing the success probability percentage of the given market. Probabilties are available 21 days before a game starts.

This endpoint is often used with relationship includes like &include=fixture.localTeam,fixture.visitorTeam.

Another option which is most popular, is adding the relationship include &include=probability to your requests from the Fixture endpoint or Livescore endpoint. You can find more info in the relationship section about fixture probabilities.

Field Description

All values are between 0 and 100
HT_over_0_5:    Home team over 0.5
HT_over_1_5:    Home Team over 1.5
HT_under_0_5:   Home Team under 0.5
HT_under_1_5:   Home Team under 1.5
AT_over_0_5:    Away team over 0.5
AT_over_1_5:    Away Team over 1.5
AT_under_0_5:   Away Team under 0.5
AT_under_1_5:   Away Team under 1.5
home:           Home team to win
draw:           Match ended in a draw
away:           Away team to win
btts:           Both team to score
correct_score:  Probabilities for the Correct Score market
0-0:            Probability correct FT score will be 0-0
0-1:            Probability correct FT score will be 0-1
1-1:            Probability correct FT score will be 1-1
over_2_5:       Over 2.5 goals
over_3.5:       Over 2.5 goals
under_2_5:      Under 2.5 goals
under_3_5:      Under 3.5 goals
Note: next to the examples above, more markets are available in the API

Endpoint Details

Below you can find the details for this endpoint.

Key Value
Endpoint: https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__
Pagination: No
Includes:
Nested Includes: - You can add a max of levels of nested includes.
Parameters: No parameters available for this endpoint.

Example Request

The following code snippets demonstrate how to get all prediction apis available in this endpoint.

// Get your API tokens here: https://www.sportmonks.com/settings#/api
curl "https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN"
-H "Accept: application/json"
// Get your API tokens here: https://www.sportmonks.com/settings#/api
$client = new GuzzleHttp\Client();
$res = $client->request('GET', 'https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN', [
    'headers' => ['Accept' => 'application/json']
]);
// Get your API tokens here: https://www.sportmonks.com/settings#/api
response = requests.get("https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN")

# Print the status code of the response.
print(response.status_code)
// Get your API tokens here: https://www.sportmonks.com/settings#/api
require 'faraday_middleware'

Faraday.new('https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN', headers: {'Accept' => 'application/json', 'Accept-Encoding' => 'gzip'}).get
// Get your API tokens here: https://www.sportmonks.com/settings#/api
URL url = new URL("https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN");
HttpURLConnection con = (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
// Get your API tokens here: https://www.sportmonks.com/settings#/api
import { SportmonksApi } from 'sportmonks';
const sportmonks = new SportmonksApi(__YOUR_API_TOKEN__);
sportmonks.get("https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN",params).then( function(resp){
  //resp.data will contain your data
  //resp.meta will contain the meta informations
  console.log(resp);
});
// Get your API tokens here: https://www.sportmonks.com/settings#/api
package main

import (
    "fmt"
    "log"

    sm "github.com/BialkowskiSz/go-sportmonks"
)

func main() {
    sm.SetAPIToken("<YOUR_TOKEN_HERE>")
    g, err := sm.Get("https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN", "", 0, false)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(string(g))
}
// Get your API tokens here: https://www.sportmonks.com/settings#/api
var client = new HttpClient();
var response = await client.GetAsync("https://soccer.sportmonks.com/api/v2.0/predictions/probabilities/fixture/__ID__?api_token=YOURTOKEN");
string json = await response.Content.ReadAsStringAsync();

Example Response

In the API Reference Guide the example responses of the prediction apis endpoint are shown.

Test this Endpoint

With our In-Page API Tester you can directly test this Endpoint by clicking the blue button on the right ‘Open Test API’. By adding Includes, Parameters and Variables and clicking the blue button on the right below ‘Send API Request’, you can directly view the API Response. Your Requests and Responses are even stored in your personal API Tester Folder (only when you are logged-in). If you are not logged in the API Tester will use the Free Plan Leagues for your requests.

Questions?

We're always happy to help with code or other questions you might have! Search our documentation, contact support, or get in touch with our sales team.

This article was last updated on
{{ api_response }}
# Variable Value Description
{{ variable.variable }} {{ variable.description }}
# Relationship Description Value
{{ parameter.parameter }} {{ parameter.description }}
# Relationship Description Extra
{{ relation.include }} {{ relation.description }}

{{ loginForm.errors.get('email') }}

{{ loginForm.errors.get('password') }}

Remember me?