Pinnacle data feed documentation

How often do the odds update?

Pinnacle data feeds update every 60 seconds, for both pre-match and live betting. Only 1 API call per minute is needed to have the latest updates at all times.

What file formats are available?

Pinnacle data feeds are available in XML, JSON, and CSV formats. CSV files can be opened with any spreadsheet application like Microsoft Excel or Apple Numbers.

Main vs alts

Change "/odds-main/" to "/odds-alts/" in the data feed URL to include even more odds:

/odds-main/:
Moneyline, spread, & total odds for full game/match only

/odds-alts/:
Moneyline, spread, total, team totals, alternate spreads, & alternate totals odds for full game/match, 1st half, & 1st period

URL parameters

Name Description Required Example
api-keyAPI keyYesapi-key=2f4cdec39f8b2a3dcd67357a80239645
isLiveIs live oddsNoisLive=0 (pregame), isLive=1 (live betting)
teamTeam name (away or home)Noteam=New+England+Patriots
idGame IDNoid=119220

Fields

Name Description Example
idGame ID (unique per node)119220
sportSportFootball
leagueLeagueNFL
sportsbookSportsbookPinnacle
startDateStart date (UTC time)2019-11-17T18:00:00Z
awayTeamAway teamDenver Broncos
homeTeamHome teamMinnesota Vikings
isLiveIs live odds0
gameCutoffDateGame cutoff date (UTC time)2019-11-17T18:00:00Z
gameMoneylineAwayPriceEUGame away team moneyline price (decimal odds)4.900
gameMoneylineHomePriceEUGame home team moneyline price (decimal odds)1.208
gameMoneylineAwayPriceUSGame away team moneyline price (american odds)+390
gameMoneylineHomePriceUSGame home team moneyline price (american odds)-481
gameSpreadAwayHandicapGame away team spread handicap+10.5
gameSpreadHomeHandicapGame home team spread handicap-10.5
gameSpreadAwayPriceEUGame away team spread price (decimal odds)1.862
gameSpreadHomePriceEUGame home team spread price (decimal odds)2.050
gameSpreadAwayPriceUSGame away team spread price (american odds)-116
gameSpreadHomePriceUSGame home team spread price (american odds)+105
gameTotalPointsGame total points40.5
gameTotalOverPriceEUGame over total price (decimal odds)2.020
gameTotalUnderPriceEUGame under total price (decimal odds)1.884
gameTotalOverPriceUSGame over total price (american odds)+102
gameTotalUnderPriceUSGame under total price (american odds)-113
gameTeamTotalAwayPointsGame away team total points13.5
gameTeamTotalAwayOverPriceEUGame away team over total price (decimal odds)1.751
gameTeamTotalAwayUnderPriceEUGame away team under total price (decimal odds)2.140
gameTeamTotalAwayOverPriceUSGame away team over total price (american odds)-133
gameTeamTotalAwayUnderPriceUSGame away team under total price (american odds)+114
gameTeamTotalHomePointsGame home team total points24.5
gameTeamTotalHomeOverPriceEUGame home team over total price (decimal odds)1.847
gameTeamTotalHomeUnderPriceEUGame home team under total price (decimal odds)2.010
gameTeamTotalHomeOverPriceUSGame home team over total price (american odds)-118
gameTeamTotalHomeUnderPriceUSGame home team under total price (american odds)+101
halfCutoffDate1st half cutoff date (UTC time)2019-11-17T18:00:00Z
halfMoneylineAwayPriceEU1st half away team moneyline price (decimal odds)3.820
halfMoneylineHomePriceEU1st half home team moneyline price (decimal odds)1.270
halfMoneylineAwayPriceUS1st half away team moneyline price (american odds)+282
halfMoneylineHomePriceUS1st half home team moneyline price (american odds)-370
halfSpreadAwayHandicap1st half away team spread handicap+6
halfSpreadHomeHandicap1st half home team spread handicap-6
halfSpreadAwayPriceEU1st half away team spread price (decimal odds)2.040
halfSpreadHomePriceEU1st half home team spread price (decimal odds)1.826
halfSpreadAwayPriceUS1st half away team spread price (american odds)+104
halfSpreadHomePriceUS1st half home team spread price (american odds)-121
halfTotalPoints1st half total points20.5
halfTotalOverPriceEU1st half over total price (decimal odds)1.909
halfTotalUnderPriceEU1st half under total price (decimal odds)1.943
halfTotalOverPriceUS1st half over total price (american odds)-110
halfTotalUnderPriceUS1st half under total price (american odds)-106
halfTeamTotalAwayPoints1st half away team total points6.5
halfTeamTotalAwayOverPriceEU1st half away team over total price (decimal odds)1.662
halfTeamTotalAwayUnderPriceEU1st half away team under total price (decimal odds)2.290
halfTeamTotalAwayOverPriceUS1st half away team over total price (american odds)-151
halfTeamTotalAwayUnderPriceUS1st half away team under total price (american odds)+129
halfTeamTotalHomePoints1st half home team total points13.5
halfTeamTotalHomeOverPriceEU1st half home team over total price (decimal odds)1.892
halfTeamTotalHomeUnderPriceEU1st half home team under total price (decimal odds)1.961
halfTeamTotalHomeOverPriceUS1st half home team over total price (american odds)-112
halfTeamTotalHomeUnderPriceUS1st half home team under total price (american odds)-104
periodCutoffDate1st period cutoff date (UTC time)2019-11-17T18:00:00Z
periodMoneylineAwayPriceEU1st period away team moneyline price (decimal odds)3.300
periodMoneylineHomePriceEU1st period home team moneyline price (decimal odds)1.346
periodMoneylineAwayPriceUS1st period away team moneyline price (american odds)+230
periodMoneylineHomePriceUS1st period home team moneyline price (american odds)-289
periodSpreadAwayHandicap1st period away team spread handicap+3
periodSpreadHomeHandicap1st period home team spread handicap-3
periodSpreadAwayPriceEU1st period away team spread price (decimal odds)1.884
periodSpreadHomePriceEU1st period home team spread price (decimal odds)1.970
periodSpreadAwayPriceUS1st period away team spread price (american odds)-113
periodSpreadHomePriceUS1st period home team spread price (american odds)-103
periodTotalPoints1st period total points7
periodTotalOverPriceEU1st period over total price (decimal odds)1.729
periodTotalUnderPriceEU1st period under total price (decimal odds)2.170
periodTotalOverPriceUS1st period over total price (american odds)-137
periodTotalUnderPriceUS1st period under total price (american odds)+117
periodTeamTotalAwayPoints1st period away team total points0.5
periodTeamTotalAwayOverPriceEU1st period away team over total price (decimal odds)2.280
periodTeamTotalAwayUnderPriceEU1st period away team under total price (decimal odds)1.666
periodTeamTotalAwayOverPriceUS1st period away team over total price (american odds)+128
periodTeamTotalAwayUnderPriceUS1st period away team under total price (american odds)-150
periodTeamTotalHomePoints1st period home team total points6.5
periodTeamTotalHomeOverPriceEU1st period home team over total price (decimal odds)1.917
periodTeamTotalHomeUnderPriceEU1st period home team under total price (decimal odds)1.934
periodTeamTotalHomeOverPriceUS1st period home team over total price (american odds)-109
periodTeamTotalHomeUnderPriceUS1st period home team under total price (american odds)-107
checkedDateLast checked date (UTC time)2019-11-16T05:07:09Z
changedDateLast changed date (UTC time)2019-11-16T05:05:02Z

Sports Data Feeds - Non-commercial use

17.94 USD / 6 months

Sports Data Feeds - Commercial use

179.94 USD / 6 months