Odds

REQUIREMENT

You'll need a license key to use OpticOdds' API. You can get one by contacting us at www.opticodds.com.

API Endpoint

https://api.opticodds.com/api/feed/game-odds/

Parameters

NOTE

You can pass in multiple of the same parameters in each GET request.

key (required)

Your OpticOdds API license key.

page

The page of the response you want. Note: the page index starts at 1, and each response returns up to 500 odds.

sportsbook

The sportsbook(s) you want to receive odds for. We support the following:

• Pinnacle
• 5Dimes
• DraftKings
• BetMGM
• WynnBET
• theScore
• Bally Bet
• Elite Sportsbook
• FOX Bet
• FanDuel
• PointsBet
• Caesars
• Barstool
• Borgota
• Unibet
• BetRivers
• Wind Creek
• BetAnySports
• BookMaker
• SugarHouse
• TwinSpires
• BetUS
• bwin
• Betfred
• Betfair
• BetOnline
• Betway
• Bovada
• Bodog
• Casumo
• 10bet
• 888sport (Canada)
• MyBookie
• Betcris
• OpticOdds (OpticOdds ' inferred odds)

marketName

The market you want to receive odds for (e.g. Moneyline)

sport

The sport you want to receive odds for. We support the following:

• football
• basketball
• baseball
• mma
• boxing
• hockey
• soccer
• tennis
• golf
• motorsports
• esports

league

The league you want to receive odds for (e.g. England - Premier League)

gameId

The OpticOdds game ID you want to receive odds for (e.g. 37621)

isMain

Flag to filter for odds for main lines (supports values true, yes, t, 1)

isLive

Flag to filter for odds for live games (supports values true, yes, t, 1)

startDateBefore

Specify this value if you want to receive all odds for a game before a specific date. Please pass in an ISO 8601 date for the best results.

startDateAfter

Specify this value if you want to receive all odds for a game after a specific date. Please pass in an ISO 8601 date for the best results.

Example Response

[
  {
    "game": {
      "id": 163896,
      "sport": "football",
      "league": "NFL",
      "start_date": "2021-11-11T20:21:00-05:00",
      "away_team": "Baltimore Ravens",
      "home_team": "Miami Dolphins",
      "is_live": false
    },
    "market_name": "Point Spread",
    "sports_book": {
      "name": "DraftKings"
    },
    "name": "Baltimore Ravens -4.5",
    "price": -195.0,
    "is_main": false,
    "is_live": false,
    "deep_link_url": null,
    "checked_date": "2021-11-11T18:35:58.017884-05:00",
    "changed_date": "2021-11-11T18:35:58.017894-05:00"
  },
  {
    "game": {
      "id": 163896,
      "sport": "football",
      "league": "NFL",
      "start_date": "2021-11-11T20:21:00-05:00",
      "away_team": "Baltimore Ravens",
      "home_team": "Miami Dolphins",
      "is_live": false
    },
    "market_name": "Total Points",
    "sports_book": {
      "name": "DraftKings"
    },
    "name": "Under 52.5",
    "price": -235.0,
    "is_main": false,
    "is_live": false,
    "deep_link_url": null,
    "checked_date": "2021-11-11T18:35:58.662274-05:00",
    "changed_date": "2021-11-11T18:35:58.662283-05:00"
  },
  {
    "game": {
      "id": 163896,
      "sport": "football",
      "league": "NFL",
      "start_date": "2021-11-11T20:21:00-05:00",
      "away_team": "Baltimore Ravens",
      "home_team": "Miami Dolphins",
      "is_live": false
    },
    "market_name": "Point Spread",
    "sports_book": {
      "name": "DraftKings"
    },
    "name": "Baltimore Ravens -16.5",
    "price": 210.0,
    "is_main": false,
    "is_live": false,
    "deep_link_url": null,
    "checked_date": "2021-11-11T18:35:57.676379-05:00",
    "changed_date": "2021-11-11T18:35:57.676391-05:00"
  },
  {
    "game": {
      "id": 163896,
      "sport": "football",
      "league": "NFL",
      "start_date": "2021-11-11T20:21:00-05:00",
      "away_team": "Baltimore Ravens",
      "home_team": "Miami Dolphins",
      "is_live": false
    },
    "market_name": "1st Field Goal Made",
    "sports_book": {
      "name": "DraftKings"
    },
    "name": "Baltimore Ravens",
    "price": -120.0,
    "is_main": false,
    "is_live": false,
    "deep_link_url": "https://sportsbook.draftkings.com/event/179825674?category=odds&subcategory=game-props",
    "checked_date": "2021-11-11T18:35:55.738083-05:00",
    "changed_date": "2021-11-11T18:35:55.738091-05:00"
  },
  ...
]

is_main

is_main 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: