Description

Get a list of odds for a given combination of fixtures, and markets. These 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) and at most 5.

fixture_id

Can pass up to 5 of these per request.

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

URL: https://api.opticodds.com/api/v3/copilot/fixtures/odds?&fixture_id=032B6289DB25

{
  "data": [
    {
      "id": "032B6289DB25",
      "game_id": "78014-37797-24-43",
      "start_date": "2024-10-25T00:15:00Z",
      "home_competitors": [
        {
          "id": "13AD4FDBEBA8",
          "name": "Los Angeles Rams",
          "abbreviation": "LAR",
          "logo": "https://cdn.opticodds.com/team-logos/football/99.png"
        }
      ],
      "away_competitors": [
        {
          "id": "24E4EA618C5E",
          "name": "Minnesota Vikings",
          "abbreviation": "MIN",
          "logo": "https://cdn.opticodds.com/team-logos/football/101.png"
        }
      ],
      "home_team_display": "Los Angeles Rams",
      "away_team_display": "Minnesota Vikings",
      "status": "unplayed",
      "is_live": false,
      "sport": {
        "id": "football",
        "name": "Football"
      },
      "league": {
        "id": "nfl",
        "name": "NFL"
      },
      "tournament": null,
      "odds": [
        {
          "id": "1:-1:032B6289DB25:point_spread:los_angeles_rams_+2_5",
          "version_id": -1,
          "version": "default",
          "odd_id": "032B6289DB25:point_spread:los_angeles_rams_+2_5",
          "market": "Point Spread",
          "name": "Los Angeles Rams +2.5",
          "is_main": true,
          "selection": "Los Angeles Rams",
          "normalized_selection": "los_angeles_rams",
          "market_id": "point_spread",
          "price": -101,
          "timestamp": 1729714816.49106,
          "grouping_key": "default:2.5",
          "points": 2.5,
          "selection_line": null,
          "player_id": null,
          "team_id": "13AD4FDBEBA8"
        },
        {
          "id": "1:-1:032B6289DB25:point_spread:minnesota_vikings_-2_5",
          "version_id": -1,
          "version": "default",
          "odd_id": "032B6289DB25:point_spread:minnesota_vikings_-2_5",
          "market": "Point Spread",
          "name": "Minnesota Vikings -2.5",
          "is_main": true,
          "selection": "Minnesota Vikings",
          "normalized_selection": "minnesota_vikings",
          "market_id": "point_spread",
          "price": -118,
          "timestamp": 1729714816.49106,
          "grouping_key": "default:2.5",
          "points": -2.5,
          "selection_line": null,
          "player_id": null,
          "team_id": "24E4EA618C5E"
        }
      ]
    }
  ]
}

settled=True

{
  "data": [
    {
      "id": "20250914453DD03A",
      "numerical_id": 258525,
      "game_id": "13602-17233-25-36",
      "start_date": "2025-09-14T20:25:00Z",
      "home_competitors": [
        {
          "id": "2D71E5BA64A5",
          "name": "Kansas City Chiefs",
          "numerical_id": 98,
          "base_id": 96,
          "abbreviation": "KC",
          "logo": "https://cdn.opticodds.com/team-logos/football/96.png"
        }
      ],
      "away_competitors": [
        {
          "id": "EDCC2866B795",
          "name": "Philadelphia Eagles",
          "numerical_id": 108,
          "base_id": 106,
          "abbreviation": "PHI",
          "logo": "https://cdn.opticodds.com/team-logos/football/106.png"
        }
      ],
      "home_team_display": "Kansas City Chiefs",
      "away_team_display": "Philadelphia Eagles",
      "status": "completed",
      "is_live": true,
      "season_type": "Regular Season",
      "season_year": "2025",
      "season_week": "2",
      "venue_name": "GEHA Field at Arrowhead Stadium",
      "venue_location": "Kansas City, MO, USA",
      "venue_neutral": false,
      "sport": {
        "id": "football",
        "name": "Football",
        "numerical_id": 9
      },
      "league": {
        "id": "nfl",
        "name": "NFL",
        "numerical_id": 367
      },
      "tournament": null,
      "odds": [
        {
          "id": "1:-1:20250914453DD03A:moneyline:kansas_city_chiefs",
          "version_id": -1,
          "version": "default",
          "odd_id": "20250914453DD03A:moneyline:kansas_city_chiefs",
          "market": "Moneyline",
          "name": "Kansas City Chiefs",
          "is_main": true,
          "selection": "Kansas City Chiefs",
          "normalized_selection": "kansas_city_chiefs",
          "market_id": "moneyline",
          "price": -115,
          "timestamp": 1749512565.94335,
          "grouping_key": "default",
          "points": null,
          "selection_line": null,
          "player_id": null,
          "team_id": "2D71E5BA64A5",
          "status": "Lost",
          "settled_at": "2025-09-14T23:24:22.012"
        },
      ],
    },
  ],
},

200success