Skip to main content
Version: 2.0.0

Historical Betting Odds API Documentation

Description

This endpoint returns all the historical betting odds & price movement for all games, filterable by markets, sportsbooks & more.

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/v2/historical-odds/

Description

This endpoint returns the historical price movement for provided game, market(s), and sportsbook(s).

NOTE

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.

NOTE

You can only pass in five or less market_name or sportsbook per request.

NOTE

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

NOTE

You can pass in multiple of this parameter.

The label of the market you want to receive. (e.g. moneyline)

sportsbook

NOTE

You can pass in multiple of this parameter.

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

  • 10bet
  • 1XBet
  • 5Dimes
  • 888sport
  • Action 24/7
  • Bally Bet
  • Barstool
  • bet365
  • BET99
  • Bet America
  • Betano
  • BetAnySports
  • Betcris
  • BetDEX
  • BetDSI
  • Betfair
  • Betfair Exchange
  • Betfred
  • betJACK
  • Betly
  • BetMGM
  • BetNow
  • BetOnline
  • BetonUSA
  • BetOpenly
  • betPARX
  • betr
  • Bet Right
  • BetRivers
  • Betr Picks
  • Betsafe
  • Betsson
  • Betstar
  • BetUK
  • BetUS
  • BetVictor
  • Betway
  • betwhale
  • BetWildwood
  • BlueBet
  • Bodog
  • BookMaker
  • Bookmaker
  • BoomBet
  • Boom Fantasy
  • Borgata
  • Bovada
  • bwin
  • Caesars
  • Casumo
  • Chalkboard
  • Circa Sports
  • Circa Vegas
  • ClutchBet
  • Codere
  • ComeOn!
  • Coolbet
  • Coral
  • Dabble
  • Dafabet
  • DAZN Bet
  • Desert Diamond
  • DraftKings
  • DRF
  • Elite Sportsbook
  • ESPN BET
  • Everygame
  • Fanatics
  • FanDuel
  • FireKeepers
  • Fliff
  • Four Winds
  • FOX Bet
  • GambetDC
  • GGBet
  • Golden Nugget
  • Hard Rock
  • Heritage
  • HotStreak
  • Intertops
  • Jazz Sports
  • Jock MKT
  • Kutt
  • Ladbrokes
  • LeoVegas
  • Looselines
  • LowVig
  • MaximBet
  • Mise-o-jeu
  • Mojo Fantasy
  • Monkey Knife Fight
  • Mr Green
  • MyBookie
  • Neds
  • Nitrogen
  • No House Advantage
  • NorthStar Bets
  • Novig
  • OddsJam Algo Odds
  • Paddy Power
  • Palmerbet
  • ParlayPlay
  • partypoker
  • Picklebet
  • Pinnacle
  • Pinny
  • Play Alberta
  • Play Eagle
  • Play Maverick
  • PlayNow
  • PlayUp
  • PointsBet
  • PowerPlay
  • PrizePicks
  • Proline
  • Prophet Exchange
  • Rebet
  • Resorts
  • Resorts World Bet
  • Rivalry
  • Royal Panda
  • SaharaBets
  • SBK
  • SI
  • Sky Bet
  • Sleeper
  • Smarkets
  • Spin Sports
  • Sportingbet
  • SportsBattle
  • Sportsbet
  • Sportsbetting.ag
  • SportsBetting.com
  • Sports Interaction
  • SportsQuack
  • Sporttrade
  • Stake
  • SugarHouse
  • SuperBook
  • SuperDraft
  • Suprabets
  • SX Bet
  • TAB
  • TABtouch
  • theScore
  • Thrillzz
  • ThriveFantasy
  • Tipico
  • TonyBet
  • TwinSpires
  • Underdog Fantasy
  • Underdog Sportsbook
  • Unibet
  • Vivid Picks
  • Westgate
  • William Hill
  • Wind Creek
  • WynnBET
  • Xbet
  • YouWager

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
},
...
],
},
...
],
}