Odds
Get match odds
Returns pre-match odds for a match, one entry per bookmaker (Bet365, Paddy Power, BetMGM UK, Pinnacle, Betfair Exchange), with the opening and latest price for each selection. Markets include match result (full time and half time), both teams to score, goals, corners and cards lines, Asian and European handicaps, team totals, match and team stat lines (shots, shots on target, throw-ins, goal kicks, tackles and offsides; shots, shots on target, throw-ins and goal kicks also by half; team fouls from Paddy Power), correct score, to qualify and penalty specials. A market appears only when that bookmaker prices it. Works for upcoming and finished matches where odds were captured; check odds_available on the match first. Returns 404 when the match has no odds. Older matches mostly have Bet365 prices only.
Example: GET /football/matches/mt_200199332/odds?bookmaker=bet365,pinnacle
GET
/
football
/
matches
/
{match_id}
/
odds
Get match odds
curl --request GET \
--url https://api.thestatsapi.com/api/football/matches/{match_id}/odds \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/matches/{match_id}/odds', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.thestatsapi.com/api/football/matches/{match_id}/odds"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"match_id": "mt_200199332",
"bookmakers": [
{
"bookmaker": "Bet365",
"markets": {
"match_odds": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw": {
"opening": "4.500",
"last_seen": "5.000"
},
"away": {
"opening": "7.500",
"last_seen": "7.500"
}
},
"btts": {
"yes": {
"opening": "2.000",
"last_seen": "2.050"
},
"no": {
"opening": "1.750",
"last_seen": "1.700"
}
},
"total_goals": {
"2.5": {
"over": {
"opening": "1.725",
"last_seen": "1.800"
},
"under": {
"opening": "2.075",
"last_seen": "2.000"
}
}
},
"match_corners": {},
"total_cards": {},
"asian_handicap": {
"home": {
"-0.5": {
"opening": "3.600",
"last_seen": "3.780"
},
"+0.0": {
"opening": "2.750",
"last_seen": "2.720"
}
},
"away": {
"+0.5": {
"opening": "1.300",
"last_seen": "1.290"
},
"+0.0": {
"opening": "1.480",
"last_seen": "1.500"
}
}
},
"draw_no_bet": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"double_chance": {
"home_draw": {
"opening": "1.380",
"last_seen": "1.380"
},
"home_away": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw_away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"first_half_result": {
"home": {
"opening": "1.833",
"last_seen": "1.909"
},
"draw": {
"opening": "2.500",
"last_seen": "2.400"
},
"away": {
"opening": "7.500",
"last_seen": "7.500"
}
},
"first_team_to_score": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
},
"none": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"second_half_result": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"half_time_double_chance": {
"home_draw": {
"opening": "1.380",
"last_seen": "1.380"
},
"home_away": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw_away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"handicap_result": {},
"team_total_goals": {
"home": {},
"away": {}
},
"btts_first_half": {
"yes": {
"opening": "1.380",
"last_seen": "1.380"
},
"no": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"btts_second_half": {
"yes": {
"opening": "1.380",
"last_seen": "1.380"
},
"no": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"first_half_total_goals": {},
"total_goals_btts": {},
"match_shots": {},
"match_shots_on_target": {},
"team_shots": {
"home": {},
"away": {}
},
"team_shots_on_target": {
"home": {},
"away": {}
},
"first_half_match_shots": {},
"second_half_match_shots": {},
"first_half_team_shots": {
"home": {},
"away": {}
},
"second_half_team_shots": {
"home": {},
"away": {}
},
"first_half_match_shots_on_target": {},
"second_half_match_shots_on_target": {},
"first_half_team_shots_on_target": {
"home": {},
"away": {}
},
"second_half_team_shots_on_target": {
"home": {},
"away": {}
},
"match_throw_ins": {},
"team_throw_ins": {
"home": {},
"away": {}
},
"first_half_match_throw_ins": {},
"second_half_match_throw_ins": {},
"first_half_team_throw_ins": {
"home": {},
"away": {}
},
"second_half_team_throw_ins": {
"home": {},
"away": {}
},
"match_goal_kicks": {},
"team_goal_kicks": {
"home": {},
"away": {}
},
"first_half_match_goal_kicks": {},
"second_half_match_goal_kicks": {},
"first_half_team_goal_kicks": {
"home": {},
"away": {}
},
"second_half_team_goal_kicks": {
"home": {},
"away": {}
},
"match_tackles": {},
"team_tackles": {
"home": {},
"away": {}
},
"match_offsides": {},
"team_offsides": {
"home": {},
"away": {}
},
"team_fouls": {
"home": {},
"away": {}
},
"team_corners": {
"home": {},
"away": {}
},
"correct_score": {},
"to_qualify": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"a_penalty_in_match": {
"yes": {
"opening": "1.380",
"last_seen": "1.380"
},
"no": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"to_score_a_penalty": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"to_miss_a_penalty": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
}
}
}
]
}
}
Walkthrough with code: Odds.
Authorizations
Your API key, sent as Authorization: Bearer YOUR_API_KEY. Get one at https://www.thestatsapi.com/api-keys
Path Parameters
Query Parameters
⌘I
Get match odds
curl --request GET \
--url https://api.thestatsapi.com/api/football/matches/{match_id}/odds \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/matches/{match_id}/odds', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.thestatsapi.com/api/football/matches/{match_id}/odds"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"match_id": "mt_200199332",
"bookmakers": [
{
"bookmaker": "Bet365",
"markets": {
"match_odds": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw": {
"opening": "4.500",
"last_seen": "5.000"
},
"away": {
"opening": "7.500",
"last_seen": "7.500"
}
},
"btts": {
"yes": {
"opening": "2.000",
"last_seen": "2.050"
},
"no": {
"opening": "1.750",
"last_seen": "1.700"
}
},
"total_goals": {
"2.5": {
"over": {
"opening": "1.725",
"last_seen": "1.800"
},
"under": {
"opening": "2.075",
"last_seen": "2.000"
}
}
},
"match_corners": {},
"total_cards": {},
"asian_handicap": {
"home": {
"-0.5": {
"opening": "3.600",
"last_seen": "3.780"
},
"+0.0": {
"opening": "2.750",
"last_seen": "2.720"
}
},
"away": {
"+0.5": {
"opening": "1.300",
"last_seen": "1.290"
},
"+0.0": {
"opening": "1.480",
"last_seen": "1.500"
}
}
},
"draw_no_bet": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"double_chance": {
"home_draw": {
"opening": "1.380",
"last_seen": "1.380"
},
"home_away": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw_away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"first_half_result": {
"home": {
"opening": "1.833",
"last_seen": "1.909"
},
"draw": {
"opening": "2.500",
"last_seen": "2.400"
},
"away": {
"opening": "7.500",
"last_seen": "7.500"
}
},
"first_team_to_score": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
},
"none": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"second_half_result": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"half_time_double_chance": {
"home_draw": {
"opening": "1.380",
"last_seen": "1.380"
},
"home_away": {
"opening": "1.380",
"last_seen": "1.380"
},
"draw_away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"handicap_result": {},
"team_total_goals": {
"home": {},
"away": {}
},
"btts_first_half": {
"yes": {
"opening": "1.380",
"last_seen": "1.380"
},
"no": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"btts_second_half": {
"yes": {
"opening": "1.380",
"last_seen": "1.380"
},
"no": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"first_half_total_goals": {},
"total_goals_btts": {},
"match_shots": {},
"match_shots_on_target": {},
"team_shots": {
"home": {},
"away": {}
},
"team_shots_on_target": {
"home": {},
"away": {}
},
"first_half_match_shots": {},
"second_half_match_shots": {},
"first_half_team_shots": {
"home": {},
"away": {}
},
"second_half_team_shots": {
"home": {},
"away": {}
},
"first_half_match_shots_on_target": {},
"second_half_match_shots_on_target": {},
"first_half_team_shots_on_target": {
"home": {},
"away": {}
},
"second_half_team_shots_on_target": {
"home": {},
"away": {}
},
"match_throw_ins": {},
"team_throw_ins": {
"home": {},
"away": {}
},
"first_half_match_throw_ins": {},
"second_half_match_throw_ins": {},
"first_half_team_throw_ins": {
"home": {},
"away": {}
},
"second_half_team_throw_ins": {
"home": {},
"away": {}
},
"match_goal_kicks": {},
"team_goal_kicks": {
"home": {},
"away": {}
},
"first_half_match_goal_kicks": {},
"second_half_match_goal_kicks": {},
"first_half_team_goal_kicks": {
"home": {},
"away": {}
},
"second_half_team_goal_kicks": {
"home": {},
"away": {}
},
"match_tackles": {},
"team_tackles": {
"home": {},
"away": {}
},
"match_offsides": {},
"team_offsides": {
"home": {},
"away": {}
},
"team_fouls": {
"home": {},
"away": {}
},
"team_corners": {
"home": {},
"away": {}
},
"correct_score": {},
"to_qualify": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"a_penalty_in_match": {
"yes": {
"opening": "1.380",
"last_seen": "1.380"
},
"no": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"to_score_a_penalty": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
},
"to_miss_a_penalty": {
"home": {
"opening": "1.380",
"last_seen": "1.380"
},
"away": {
"opening": "1.380",
"last_seen": "1.380"
}
}
}
}
]
}
}