GET All Odds

Base URL

https://api.sportmonks.com/v3/{sport}/pre-match

Example Response

        {
            "id": 1040325,
            "fixture_id": 18557891,
            "market_id": 1,
            "bookmaker_id": 28,
            "label": "1",
            "value": "2.05",
            "name": "Home",
            "sort_order": null,
            "market_description": "Match Winner",
            "probability": "48.78%",
            "dp3": "2.050",
            "fractional": "31/15",
            "american": "104",
            "winning": false,
            "stopped": false,
            "total": null,
            "handicap": null,
            "participants": "10266"
        },
        {
            "id": 1040326,
            "fixture_id": 18557891,
            "market_id": 1,
            "bookmaker_id": 28,
            "label": "X",
            "value": "3.10",
            "name": "Draw",
            "sort_order": null,
            "market_description": "Match Winner",
            "probability": "32.26%",
            "dp3": "3.100",
            "fractional": "25/8",
            "american": "210",
            "winning": false,
            "stopped": false,
            "total": null,
            "handicap": null,
            "participants": null
        },
        {
            "id": 1040327,
            "fixture_id": 18557891,
            "market_id": 1,
            "bookmaker_id": 28,
            "label": "2",
            "value": "3.20",
            "name": "Away",
            "sort_order": null,
            "market_description": "Match Winner",
            "probability": "31.25%",
            "dp3": "3.200",
            "fractional": "16/5",
            "american": "220",
            "winning": false,
            "stopped": false,
            "total": null,
            "handicap": null,
            "participants": "6157"
        },

Field Description

Query Parameters

Query Parameters	Required?	Description
api_token	YES	Your unique API token
include	NO	Enrich the API with more data by using includes
select	NO	Select specific fields on the base entity
filters	NO	Filter the API response on multiple related entities. There are static filters and dynamic filters.​Please find the possibilities in the Static and Dynamic Filter tab.

Static Filters

Static filters are always the same and filter in one specific way without any custom options. Each static filter is listed below and has a description of how it filters. For more information, please look at our Filters page.

Static Filters	Available on Entity	Description	Example
IdAfter	All	Filter all inplay odds starting from a certain inplay odd ID. Handy if you're doing an import for all inplay odds and want to continue from a certain ID.	&filters=IdAfter:inplayoddID &filters=IdAfter:4430465
Deleted	Fixture	Filter on deleted fixtures only. This filter helps to keep your database in sync.	&include=fixtures&filters=IsDeleted
Markets	Odds	Filter the odds on a selection of markets separated by a comma.	&filters=markets:marketIDs &filters=markets:12,14
Bookmakers	Odds	Filter the odds on a selection of bookmakers separated by a comma. (e.g: 2,14).	&filters=bookmakers:bookmakerIDs &filters=bookmakers:2,14
WinningOdds	Odds	Filter all winning odds.	&filters=winningOdds

Dynamic Filters

Not applicable for this endpoint.

Pagination

YES

Include depth

You can use a total of 1 nested includes on this endpoint

Include options

fixture market bookmaker

Related entities

Odd

Code Example

Ruby

require "uri"
require "net/http"

url = URI("https://api.sportmonks.com/v3/odds/pre-match?api_token={your_token}")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Python

import http.client

conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/odds/pre-match?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.sportmonks.com/v3/odds/pre-match?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 $respons

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api.sportmonks.com/v3/odds/pre-match?api_token={your_token}")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();

Node.js

var unirest = require('unirest');
var req = unirest('GET', 'https://api.sportmonks.com/v3/odds/pre-match?api_token={your_token}')
  .end(function (res) { 
    if (res.error) throw new Error(res.error); 
    console.log(res.raw_body);
  });

Go

package main

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

func main() {

  url := "https://api.sportmonks.com/v3/odds/pre-match?api_token={your_token}"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, 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))
}