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). 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.fanduel.com/addToBetslip?marketId=42.441564663&selectionId=29170",
     "android": "fanduelsportsbook://account.sportsbook.fanduel.com/sportsbook/addToBetslip?marketId=42.441564663&selectionId=29170",
     "desktop": "https://sportsbook.fanduel.com/addToBetslip?marketId=42.441564663&selectionId=29170"
}

Odds

URL: https://api.opticodds.com/api/v3/fixtures/odds?&sportsbook=FanDuel&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:fanduel:moneyline:houston_astros",
          "sportsbook": "FanDuel",
          "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,
        },
        {
          "id": "60486-35183-2024-08-29-17:fanduel:moneyline:kansas_city_royals",
          "sportsbook": "FanDuel",
          "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,
        },
        {
          "id": "60486-35183-2024-08-29-17:fanduel:run_line:houston_astros_-1_5",
          "sportsbook": "FanDuel",
          "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,
        },
        {
          "id": "60486-35183-2024-08-29-17:fanduel:run_line:kansas_city_royals_+1_5",
          "sportsbook": "FanDuel",
          "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,
        },
        {
          "id": "60486-35183-2024-08-29-17:fanduel:total_runs:over_8",
          "sportsbook": "FanDuel",
          "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,
        },
        {
          "id": "60486-35183-2024-08-29-17:fanduel:total_runs:under_8",
          "sportsbook": "FanDuel",
          "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,
        }
      ]
    }
  ]
}
Language
Authorization
Click Try It! to start a request and see the response here!