Historical Betting Odds API Documentation
Description
This endpoint returns all the historical betting odds & price movement for all games, filterable by markets, sportsbooks & more.
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/v2/historical-odds/
Description
This endpoint returns the historical price movement for provided game, market(s), and sportsbook(s).
Historical odds are only available from March 18, 2024 and onwards.
Odds only include values prior to a game starting.
Parameters
key (required)
Your OpticOdds API license key.
You can only pass in five or less market_name or sportsbook per request.
At least one game_id, market_name, and sportsbook is required per request.
game_id
The game_id you want to receive odds for (e.g. 13602-17233-23-06)
market_name
You can pass in multiple of this parameter.
The label of the market you want to receive. (e.g. moneyline)
sportsbook
You can pass in multiple of this parameter.
The sportsbook(s) you want to receive odds for. We support the following:
10bet1XBet22bet5Dimes888sportAction 24/7Bally BetBarstoolBC.GAMEbet365BET99Bet AmericaBetanoBetAnySportsBetcrisBetDEXBetDSIBetfairBetfair ExchangeBetfredbetJACKBetlyBetMGMBetnacionalBetNowBetOnlineBetonUSABetOpenlybetPARXBetplaybetrBet RightBetRiversBetr PicksBetsafeBetssonBetstarBetUKBetUSBetVictorBetwaybetwhaleBetWildwoodBlueBetBodogBookMakerBookmakerBoomBetBoom FantasyBorgataBovadabwinCaesarsCasumoChalkboardCirca SportsCirca VegasClutchBetCodereComeOn!CoolbetCoralCrab SportsDabbleDafabetDAZN BetDesert DiamondDraftKingsDRFElite SportsbookESPN BETEverygameFanaticsFanDuelFireKeepersFliffFour WindsFOX BetGalera.betGambetDCGGBetGolden NuggetHard RockHeritageHotStreakIntertopsJazz SportsJock MKTJuiceBetKuttLadbrokesLeoVegasLooselinesLowVigMaximBetMise-o-jeuMojo FantasyMonkey Knife FightMr GreenMyBookieNedsNitrogenNo House AdvantageNorthStar BetsNovigOddsJam Algo OddsPaddy PowerPalmerbetParlayPlaypartypokerPicklebetPinnaclePinnyPlay AlbertaPlay EaglePlay MaverickPlayNowPlayUpPointsBetPowerPlayPrizePicksProlineProphet ExchangeProphet XRebetResortsResorts World BetRivalryRoyal PandaSaharaBetsSBKSISky BetSleeperSmarketsSpin SportsSportingbetSportsBattleSportsbetSportsbetting.agSportsBetting.comSports InteractionSportsQuackSporttradeStakeSTN SportsSugarHouseSuperbetSuperBookSuperDraftSuprabetsSX BetTABTABtouchtheScoreThrillzzThriveFantasyTipicoTonyBetTwinSpiresUnderdog FantasyUnderdog SportsbookUnibetVivid PicksWestgateWilliam HillWind CreekWynnBETXbetYouWager
is_main
Flag to filter for odds for main lines (supports values true, yes, t, 1).
Example Response
The timestamps that are returned are UTC timestamps in milliseconds (see https://www.unixtimestamp.com/ for more information).
{
"data": [
{
"game_id": "37337-80389-2023-04-23-11",
"market": "Moneyline",
"sportsbook": "William Hill",
"bet": "Milwaukee Brewers",
"values": [
{
"timestamp": 1685025360342,
"price": 112
},
{
"timestamp": 1685046179776,
"price": 116
},
{
"timestamp": 1685046569831,
"price": 114
},
{
"timestamp": 1685053544884,
"price": 116
}
]
},
...
]
}
Example Response with is_main=true
{
"data": [
{
"game_id": "33128-12806-23-45",
"market": "Point Spread",
"sportsbook": "DraftKings",
"bet": "Los Angeles Chargers",
"values": [
{
"timestamp": 1698413640354,
"price": -110.0,
"points": -1.5
},
{
"timestamp": 1698618861211,
"price": -110.0,
"points": -1.5
},
{
"timestamp": 1698643180550,
"price": -110.0,
"points": -1.5
},
{
"timestamp": 1698674242611,
"price": -110.0,
"points": -2.5
},
{
"timestamp": 1698677617299,
"price": -108.0,
"points": -3.0
},
...
],
},
...
],
}