Description
Get a list of odds for a given combination of sportsbooks, fixtures, and markets. These game odds are related to specific events, they do not apply for entire tournaments or entire seasons.
Specific Parameter Information
For a full list of parameters, scroll to the bottom of this page.
You must pass at least one of the following (fixture_id, team_id, player_id) as well as at least 1 sportsbook and at most 5.
fixture_id
Can pass up to 5 of these per request.
sportsbook
The sportsbooks that you want odds for. You can pass up to 5 of these per request. You can pass the id or the name.
market
The markets that you want odds for. You can pass the id or the name.
is_main
This parameter indicates whether a line is the "main" or "given" line for a market. For example, the +/- 6 Point Spread and the Over/Under 46.5 Total Points lines are the "main" lines for the DraftKings game below:
odds_format
Needs to be one of the following (AMERICAN, DECIMAL, PROBABILITY, MALAY, HONG_KONG, INDONESIAN). This defaults to AMERICAN.
Example Responses
Notes
If you have permissions to view Deep Link Information then you will see `deep_link
Deep Link's Enabled
If you have this permission enabled on your api key, then you will see the following returned for the deep_link field on each odd if we have the information available, otherwise it will be null
"deep_link": {
"ios": "https://sportsbook.caesars.com/addToBetslip?marketId=42.441564663&selectionId=29170",
"android": "caesarssportsbook://account.sportsbook.caesars.com/sportsbook/addToBetslip?marketId=42.441564663&selectionId=29170",
"desktop": "https://sportsbook.caesars.com/addToBetslip?marketId=42.441564663&selectionId=29170"
}
Odds
URL: https://api.opticodds.com/api/v3/fixtures/odds?&sportsbook=Pinnacle&fixture_id=BCE4E01B8D3D
{
"data": [
{
"id": "BCE4E01B8D3D",
"game_id": "60486-35183-2024-08-29-17",
"start_date": "2024-08-30T00:10:00Z",
"home_competitors": [
{
"id": "4F11A5896C24",
"name": "Houston Astros",
"abbreviation": "HOU",
"logo": "https://a.espncdn.com/i/teamlogos/mlb/500/hou.png"
}
],
"away_competitors": [
{
"id": "E970E2EDDCAE",
"name": "Kansas City Royals",
"abbreviation": "KAN",
"logo": "https://a.espncdn.com/i/teamlogos/mlb/500/kc.png"
}
],
"home_team_display": "Houston Astros",
"away_team_display": "Kansas City Royals",
"status": "unplayed",
"is_live": false,
"sport": {
"id": "baseball",
"name": "Baseball"
},
"league": {
"id": "mlb",
"name": "MLB"
},
"tournament": null,
"odds": [
{
"id": "60486-35183-2024-08-29-17:pinnacle:moneyline:houston_astros",
"sportsbook": "Pinnacle",
"market": "Moneyline",
"name": "Houston Astros",
"is_main": true,
"selection": "Houston Astros",
"normalized_selection": "houston_astros",
"market_id": "moneyline",
"selection_line": null,
"player_id": null,
"team_id": "4F11A5896C24",
"price": -156,
"timestamp": 1724865905.59815,
"grouping_key": "default",
"points": null,
"deep_link": null,
"limits": {
"max": 500
}
},
{
"id": "60486-35183-2024-08-29-17:pinnacle:moneyline:kansas_city_royals",
"sportsbook": "Pinnacle",
"market": "Moneyline",
"name": "Kansas City Royals",
"is_main": true,
"selection": "Kansas City Royals",
"normalized_selection": "kansas_city_royals",
"market_id": "moneyline",
"selection_line": null,
"player_id": null,
"team_id": "E970E2EDDCAE",
"price": 132,
"timestamp": 1724865905.59815,
"grouping_key": "default",
"points": null,
"deep_link": null,
"limits": {
"max": 500
}
},
{
"id": "60486-35183-2024-08-29-17:pinnacle:run_line:houston_astros_-1_5",
"sportsbook": "Pinnacle",
"market": "Run Line",
"name": "Houston Astros -1.5",
"is_main": true,
"selection": "Houston Astros",
"normalized_selection": "houston_astros",
"market_id": "run_line",
"selection_line": null,
"player_id": null,
"team_id": "4F11A5896C24",
"price": 140,
"timestamp": 1724865905.59815,
"grouping_key": "default:-1.5",
"points": -1.5,
"deep_link": null,
"limits": null
},
{
"id": "60486-35183-2024-08-29-17:pinnacle:run_line:kansas_city_royals_+1_5",
"sportsbook": "Pinnacle",
"market": "Run Line",
"name": "Kansas City Royals +1.5",
"is_main": true,
"selection": "Kansas City Royals",
"normalized_selection": "kansas_city_royals",
"market_id": "run_line",
"selection_line": null,
"player_id": null,
"team_id": "E970E2EDDCAE",
"price": -170,
"timestamp": 1724865905.59815,
"grouping_key": "default:-1.5",
"points": 1.5,
"deep_link": null,
"limits": {
"max": 500
}
},
{
"id": "60486-35183-2024-08-29-17:pinnacle:total_runs:over_8",
"sportsbook": "Pinnacle",
"market": "Total Runs",
"name": "Over 8",
"is_main": true,
"selection": "",
"normalized_selection": "",
"market_id": "total_runs",
"selection_line": "over",
"player_id": null,
"team_id": null,
"price": -110,
"timestamp": 1724865905.59815,
"grouping_key": "default:8.0",
"points": 8,
"deep_link": null,
"limits": null,
},
{
"id": "60486-35183-2024-08-29-17:pinnacle:total_runs:under_8",
"sportsbook": "Pinnacle",
"market": "Total Runs",
"name": "Under 8",
"is_main": true,
"selection": "",
"normalized_selection": "",
"market_id": "total_runs",
"selection_line": "under",
"player_id": null,
"team_id": null,
"price": -110,
"timestamp": 1724865905.59815,
"grouping_key": "default:8.0",
"points": 8,
"deep_link": null,
"limits": {
"max": 500
}
}
]
}
]
}