Leagues & Performance

  • Basic
  • Standard
  • Advanced
  • Custom

Introduction

Via this endpoint you will get a list of leagues that have coverage for the predicition api. Next to this we also provide indicators about the performance of predictions made for these leagues on a per league basis.

Fied Descriptions

model_log_loss: ex: -1.01 is the model log loss for the given league start to be really good above -1.02. It is an average over last 50 matches.
model_hit_ratio: ex 0.58. This is mean 58% of the time the model has been correct in its prediction of 1x2. It is always between 0 and 1.   It is an average over last 50 matches.
model_predictability: ex high: This is our classification of the model performance for the given league. It can value poor, medium, good, high.
model_predictive_power: ex unchanged. This is an indicator of the model performance trend: it can value  unchanged, up and down. For instance up means the model accuracy has increased over the last 50 matches compared to the previous 50 matches.

Endpoint Details

Below you can find the details for this endpoint.

Key Value
Endpoint: https://soccer.sportmonks.com/api/v2.0/predictions/leagues
Pagination: No
Includes: No includes available for this endpoint.
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/leagues?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/leagues?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/leagues?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/leagues?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/leagues?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/leagues?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/leagues?api_token=YOURTOKEN", "", 0, false)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(string(g))
}

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?