Description
Get a list of odds and limits 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.
We only return odds that are available, if an odd is not returned then it is for all intents and purposes suspended.
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
}
}
]
}
]
}