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 for two weeks after a game ends.
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:
10bet1XBet5Dimes888sportAction 24/7Bally BetBarstoolbet365BET99Bet AmericaBetanoBetAnySportsBetcrisBetDEXBetDSIBetfairBetfair ExchangeBetfredbetJACKBetlyBetMGMBetNowBetOnlineBetonUSABetOpenlybetPARXbetrBet RightBetRiversBetr PicksBetsafeBetssonBetstarBetUKBetUSBetVictorBetwayBetWildwoodBlueBetBodogBookMakerBookmakerBoomBetBoom FantasyBorgataBovadabwinCaesarsCasumoChalkboardCirca SportsCirca VegasClutchBetCodereComeOn!CoolbetCoralDabbleDafabetDAZN BetDesert DiamondDraftKingsDRFElite SportsbookESPN BETEverygameFanaticsFanDuelFireKeepersFliffFour WindsFOX BetGambetDCGGBetGolden NuggetHard RockHeritageHotStreakIntertopsJazz SportsJock MKTKuttLadbrokesLeoVegasLooselinesLowVigMaximBetMise-o-jeuMojo FantasyMonkey Knife FightMr GreenMyBookieNedsNitrogenNo House AdvantageNorthStar BetsNovigOddsJam Algo OddsPaddy PowerPalmerbetParlayPlaypartypokerPicklebetPinnaclePinnyPlay AlbertaPlay EaglePlay MaverickPlayNowPlayUpPointsBetPowerPlayPrizePicksProlineProphet ExchangeRebetResortsResorts World BetRivalryRoyal PandaSaharaBetsSBKSISky BetSleeperSmarketsSpin SportsSportsBattleSportsbetSportsbetting.agSportsBetting.comSports InteractionSportsQuackSporttradeStakeSugarHouseSuperBookSuperDraftSuprabetsSX BetTABTABtouchtheScoreThriveFantasyTipicoTonyBetTwinSpiresUnderdog 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
},
...
],
},
...
],
}