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.

Best Practice: Sportsbook Redundancy

Use a basket of books — not a single source — as the foundation of your data.

Sportsbooks experience their own downtime: site issues, maintenance windows, and outages happen across every major operator. Building your odds logic around any single source creates a point of failure that is outside your control.

What to do instead

The /fixtures/odds endpoint accepts multiple sportsbooks in a single request. Use this to build redundancy into your integration from day one.

Why this matters

If you're automating decisions off live odds, a missing line is a live risk exposure. A multi-book setup ensures individual source failures degrade gracefully rather than taking your system offline.

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.

Note: Multiple sportsbooks must be passed as repeated query parameters (e.g., sportsbook=X&sportsbook=Y), not comma-delimited values.

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=BetMGM&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:BetMGM:moneyline:houston_astros",
          "sportsbook": "BetMGM",
          "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:BetMGM:moneyline:kansas_city_royals",
          "sportsbook": "BetMGM",
          "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:BetMGM:run_line:houston_astros_-1_5",
          "sportsbook": "BetMGM",
          "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:BetMGM:run_line:kansas_city_royals_+1_5",
          "sportsbook": "BetMGM",
          "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:BetMGM:total_runs:over_8",
          "sportsbook": "BetMGM",
          "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:BetMGM:total_runs:under_8",
          "sportsbook": "BetMGM",
          "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
          }
        }
      ]
    }
  ]
}

200success