Subscription to this function is not available for your account. To upgrade and receive access to this contact sales@datasportsgroup.com
v3 GET /cycling/get_odds
Returns all matches (and related events) that belong to a season, round or match
Request URL
https://dsg-api.com/clients/{client_name}/cycling/get_odds?day={day}&type=season&client={client_name}&authkey={client_authkey}
API Threshold
  • 10k calls per hour (2.78 calls per second)
  • This threshold applies to ALL your calls you do across the API.
  • Your number of calls get reset every hour at :00
  • If the thresold is reached within the hour you will get a xml/json message accordingly (which is gone when the next hour starts, see previous point)
Parameters
authkey
string Required
client authentification key
client
string Required
unique client ID
day
string Required
date in format yyyy-mm-dd
lang
string
two-character language code, defaults to 'en'
p
int
use to call different pages
type
string Required
type is either "season" or "match" (for season-based odds or match-based odds)
Nodes
competition
details about the competition
competition_id
unique identifier for a competition
competition_name
name of the competition
match
details about this odds match
date
date of match, format 'yyyy-mm-dd' (CET)
date_utc
date of match, format 'yyyy-mm-dd' (UTC)
final_period
display the period in which the match finished.
last_updated
When record was last updated. Format YYYY-MM-DD HH:MM:SS in CET timezone.
match_id
unique identifier of match
score_a
full-time score of team_a
score_b
full-time score of team_b
status
status of the game (Played, Playing, Fixture, Cancelled, Postponed, Suspended, Awarded, Break, Retired, Bye, No Contest, Disqualified, Tech Knockout, Knockout, Draw, Submission) + (Cricket-specific = No Result, Tea, Lunch, Dinner, between Innings, Stumps, rain delay, bad light, crowd trouble, pitch condition, start delay, drinks, super over, floodlight failure)
team_a_area_code
three-letter-acronym of the area where the home team origins
team_a_area_id
unique area_id for team_a
team_a_area_name
area name of home team origins county
team_a_id
unique team ID for team_a
team_a_name
current name of team_a
team_a_original_name
the real name at the particular season (so can differ to current name)
team_a_short_name
short name of the home team
team_a_tla_name
three-letter-acronym of team_a
team_b_area_code
three-letter-acronym of the area where the home team origins
team_b_area_id
unique area_id for team_b
team_b_area_name
area name of away team origins county
team_b_id
unique team ID for team_b
team_b_name
current name of team_b
team_b_original_name
the real name at the particular season (so can differ to current name)
team_b_short_name
short name of team_b
team_b_tla_name
three-letter-acronym of team_b
time
start time (CET), format 'hh:mm:ss'.
time_utc
start time (UTC), format 'hh:mm:ss'
winner
determines the winner of match ('team_A','team_B','draw','yet unknown')
match_extra
extra informations about the match
attendance
amount of people that attended the particular match
gameweek
contains the gameweek a match belongs to.
method
details about the API function
method_id
unique ID of method
name
name of method
odd
odd details per bookmaker
bookmaker
name of the bookmaker
bookmaker_id
unique identifier of the bookmaker
odds
odds (decimal) for this bookmaker and the outcome
odds_american
odds (american) for this bookmaker and the outcome
odds_fractional
odds (fractional) for this bookmaker and the outcome
status
status of the odd
offer
details about a specific offer
offer_subtype
sub type of the offer
offer_subtype_id
unique identifier for sub type of the offer
offer_type
type of the offer
offer_type_id
unique identifier for type of the offer
outcome
details about possible outcomes
average
average line of the specific outcome (of all bookmakers listed)
highest
highest line of the specific outcome (of all bookmakers listed)
line
line of the specific outcome
lowest
lowest line of the specific outcome (of all bookmakers listed)
outcome
possible outcome of an offer
period
details about periods of the match
score_a
period score of team_a
score_b
period score of team_b
type
three-letter-acronym of the period
round
basic identifier details about the round
round_id
unique identifier of round
season
identifier details of the season
season_id
unique identifier for season
venue
basic details about the venue
venue_area_id
unique identifier for an area
venue_area_name
name of the area
venue_city
city where the venue is based
venue_id
unique identifier of the venue
venue_name
current name of the venue
Response Headers
200
Success
401
Unauthorized
429
Too Many Requests
Code Samples
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://dsg-api.com/clients/{client_name}/cycling/get_odds?day={day}&type=season&client={client_name}&authkey={client_authkey}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "{User}:{Password}");
$content = curl_exec($ch);
curl_close($ch);
?>
curl GET -u "User:Password" "https://dsg-api.com/clients/{client_name}/cycling/get_odds?day={day}&type=season&client={client_name}&authkey={client_authkey}"
Imports System
Imports System.Net	
Imports System.IO
Imports System.Text

Public Module Module1
	Public Sub Main()
		Dim url As String = "https://dsg-api.com/clients/{client_name}/cycling/get_odds?day={day}&type=season&client={client_name}&authkey={client_authkey}"
		Dim myReq As WebRequest = WebRequest.Create(url)
		myReq.Credentials = new System.Net.NetworkCredential("{User}", "{Password}")
		Dim wr As WebResponse = myReq.GetResponse()
		Dim receiveStream As Stream = wr.GetResponseStream()
		Dim reader As StreamReader = New StreamReader(receiveStream, Encoding.UTF8)
		Dim content As String = reader.ReadToEnd()
	End Sub
End Module
response = requests.get("https://dsg-api.com/clients/{client_name}/cycling/get_odds?day={day}&type=season&client={client_name}&authkey={client_authkey}", auth=("User", "Password"))
Response Example
200 Success