{"id":4260,"date":"2026-09-29T10:00:00","date_gmt":"2026-09-29T10:00:00","guid":{"rendered":"https:\/\/oddspapi.io\/blog\/?p=4260"},"modified":"2026-09-18T13:25:47","modified_gmt":"2026-09-18T13:25:47","slug":"nhl-first-period-odds-api","status":"publish","type":"post","link":"https:\/\/oddspapi.io\/blog\/nhl-first-period-odds-api\/","title":{"rendered":"NHL Odds API: 95 Books Price the First Period Before Puck Drop"},"content":{"rendered":"

The NHL season opens on 29 September 2026, and Carolina Hurricanes v Florida Panthers carries 225 bookmakers eleven days out. Most developers pull the moneyline, the puck line and the total off that board and stop. They walk past 95 market IDs.<\/p>\n

Those 95 IDs settle on a single period. First Period Result, Second Period Total, Third Period Handicap: a separate board with its own bookmakers, its own margins and its own clock. Every number below comes from a live call made on 18 September 2026 at 13:19 UTC.<\/p>\n

The Period Board Is a Third of the Catalogue<\/h2>\n

One \/v4\/odds<\/code> call on the opener returns 270 market IDs. Split them on the period<\/code> field from \/v4\/markets<\/code> and the board separates into five stacks.<\/p>\n

\n\n\n\n\n\n\n\n\n\n
period<\/code><\/th>\nSettles on<\/th>\nMarket IDs<\/th>\nBookmakers<\/th>\nPrices<\/th>\nLive<\/th>\n<\/tr>\n<\/thead>\n
fulltime<\/code><\/td>\nthe score after 60 minutes<\/td>\n97<\/td>\n209<\/td>\n9,642<\/td>\n65.9%<\/td>\n<\/tr>\n
result<\/code><\/td>\nthe final score, overtime and shootout included<\/td>\n77<\/td>\n207<\/td>\n4,902<\/td>\n45.3%<\/td>\n<\/tr>\n
p1<\/code><\/td>\nthe first period alone<\/td>\n35<\/td>\n95<\/td>\n1,516<\/td>\n93.6%<\/td>\n<\/tr>\n
p2<\/code><\/td>\nthe second period alone<\/td>\n30<\/td>\n55<\/td>\n816<\/td>\n99.1%<\/td>\n<\/tr>\n
p3<\/code><\/td>\nthe third period alone<\/td>\n30<\/td>\n55<\/td>\n736<\/td>\n99.7%<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Read the Live column again. The two full-game stacks run 66% and 45% live. The three period stacks run 94%, 99% and 100%. The full-game side is mostly alternate-line ladder, 31 handicap rungs and 25 total rungs deep, and a book posts the whole ladder while quoting two or three rungs of it. The period board carries no deep ladder, so almost every rung on it is a price you can act on.<\/p>\n

One more ID sits outside the five stacks. 151276<\/code> Will There Be Overtime ships with period: null<\/code>, quoted by 60 books at 98.3% live. Guard your period lookup against a null.<\/p>\n

Old Way vs OddsPapi<\/h3>\n
\n\n\n\n\n\n\n\n\n\n
Job<\/th>\nScraping or a single-book feed<\/th>\nOddsPapi<\/th>\n<\/tr>\n<\/thead>\n
Find every first-period market<\/td>\nRead one sportsbook’s markup and guess the rest<\/td>\nFilter 270 IDs on period == \"p1\"<\/code><\/td>\n<\/tr>\n
Rank the first-period price<\/td>\n2 or 3 books<\/td>\n95 books on one fixture<\/td>\n<\/tr>\n
Know which clock a market settles on<\/td>\nParse the market’s display name<\/td>\nRead the period<\/code> field<\/td>\n<\/tr>\n
Grade it after the final horn<\/td>\nScrape a scoreboard<\/td>\n\/v4\/settlements<\/code> returns WIN, LOSE or PUSH per outcome<\/td>\n<\/tr>\n
Price<\/td>\nProxies, breakage, legal risk<\/td>\nFree tier, 250 requests a month, no card<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Step 1: Find the Fixtures<\/h2>\n

Ice hockey is sportId<\/code> 15 and the NHL is tournamentId<\/code> 234. Filter on both. The catalogue holds two extraliga<\/code> tournaments, and \/v4\/fixtures<\/code> returns HTTP 400 on a date range wider than ten days when sportId<\/code> is your only filter.<\/p>\n

import os, requests\n\nAPI_KEY = os.environ[\"ODDSPAPI_API_KEY\"]\nBASE = \"https:\/\/api.oddspapi.io\/v4\"\n\nr = requests.get(f\"{BASE}\/fixtures\", params={\n    \"apiKey\": API_KEY,\n    \"sportId\": 15,          # Ice Hockey\n    \"tournamentId\": 234,    # NHL\n    \"from\": \"2026-09-29\",\n    \"to\": \"2026-10-05\",\n})\nr.raise_for_status()\nfixtures = r.json()\n\nfor f in sorted(fixtures, key=lambda x: x[\"startTime\"])[:5]:\n    print(f[\"fixtureId\"], f[\"startTime\"],\n          f[\"participant1Name\"], \"v\", f[\"participant2Name\"])\nprint(f\"{len(fixtures)} fixtures, {sum(1 for f in fixtures if f['hasOdds'])} priced\")<\/code><\/pre>\n
Opening week returns 38 fixtures and all 38 are priced:<\/p>\n
id1500023472886402 2026-09-29T21:00:00.000Z Carolina Hurricanes v Florida Panthers\nid1500023472886404 2026-09-29T23:00:00.000Z Toronto Maple Leafs v Montreal Canadiens\nid1500023472886406 2026-09-30T00:00:00.000Z Boston Bruins v New York Rangers\nid1500023472886408 2026-09-30T02:00:00.000Z Edmonton Oilers v Vancouver Canucks\nid1500023472886410 2026-09-30T02:30:00.000Z Vegas Golden Knights v Chicago Blackhawks\n38 fixtures, 38 priced<\/code><\/pre>\n
Step 2: Split the Board on the Period Field<\/h2>\n
\/v4\/markets<\/code> ignores sportId<\/code> and returns all 33,115 definitions, so pull it once and index it in memory. Check the status code before you read the payload. A 429 body is valid JSON, so a check on the payload alone reads a rate limit as an empty board. Give the helper a plain exponential backoff on 5xx too, and the same function serves every endpoint in this post.<\/p>\n
import os, time, requests\nfrom collections import defaultdict\n\nAPI_KEY = os.environ[\"ODDSPAPI_API_KEY\"]\nBASE = \"https:\/\/api.oddspapi.io\/v4\"\nFIXTURE = \"id1500023472886402\"   # Carolina Hurricanes v Florida Panthers\n\ndef call(path, **params):\n    \"\"\"Retry a 429 on the body's retryMs, and back off on a transient 5xx.\"\"\"\n    params[\"apiKey\"] = API_KEY\n    for attempt in range(5):\n        r = requests.get(f\"{BASE}\/{path}\", params=params, timeout=300)\n        if r.status_code == 429:\n            time.sleep(r.json()[\"error\"].get(\"retryMs\", 1500) \/ 1000 + 0.5)\n            continue\n        if r.status_code >= 500:\n            time.sleep(2 ** attempt)\n            continue\n        r.raise_for_status()\n        return r.json()\n    raise RuntimeError(f\"{path} did not answer\")\n\n# \/markets ignores sportId and returns the whole catalogue, so index it once.\nMARKET = {str(m[\"marketId\"]): m for m in call(\"markets\")}\nboard = call(\"odds\", fixtureId=FIXTURE)\n\nstats = defaultdict(lambda: {\"ids\": set(), \"books\": set(), \"prices\": 0, \"live\": 0})\nfor slug, book in board[\"bookmakerOdds\"].items():\n    for market_id, market in book[\"markets\"].items():\n        row = stats[MARKET.get(market_id, {}).get(\"period\")]\n        row[\"ids\"].add(market_id)\n        row[\"books\"].add(slug)\n        for outcome in market[\"outcomes\"].values():\n            for price in outcome[\"players\"].values():\n                row[\"prices\"] += 1\n                row[\"live\"] += bool(price[\"active\"])\n\nprint(f\"{len(board['bookmakerOdds'])} bookmakers on the fixture\")\nprint(f\"{'period':10} {'ids':>5} {'books':>6} {'prices':>7} {'live':>7}\")\nfor period, row in sorted(stats.items(), key=lambda x: -x[1][\"prices\"]):\n    print(f\"{str(period):10} {len(row['ids']):5} {len(row['books']):6} \"\n          f\"{row['prices']:7} {row['live'] \/ row['prices']:6.1%}\")<\/code><\/pre>\n
That prints the table above. Do not resolve a period market by its name. First Period Total and Total both read as a totals market, they both carry a handicap<\/code> of 1.5 or 6.5, and only the period<\/code> field separates them. You hit the same problem on CS2, where Maps Handicap is 15 market IDs sharing one name<\/a>.<\/p>\n
Step 3: See Who Quotes Each Period<\/h2>\n
The three periods do not draw the same bookmakers. On the opener, 95 books quote at least one first-period market, 55 quote all three periods, and 40 quote the first period and nothing after it.<\/p>\n
\n\n\n\n\n\n\n\n\n
Population<\/th>\nBooks<\/th>\n<\/tr>\n<\/thead>\n
Quote the first period<\/td>\n95<\/td>\n<\/tr>\n
Quote all three periods<\/td>\n55<\/td>\n<\/tr>\n
Quote the first period only<\/td>\n40<\/td>\n<\/tr>\n
On the fixture at all<\/td>\n225<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n
Those 40 first-period-only books include bovada.lv<\/code>, bodog.eu<\/code>, hardrockbet<\/code>, playnow<\/code>, bet99<\/code>, betmgm.bet.br<\/code> and the Betano regional feeds. Build your bookmaker list per period, not per fixture. A list built off the moneyline board will send you looking for a third-period price that 170 of those books never posted.<\/p>\n
Step 4: Rank the First-Period Board<\/h2>\n
Counting legs is the guard that matters here. A book that posts two legs of a three-way first-period market computes as a cheap quote and floats to the top of any margin ranking. Read marketLength<\/code> off \/v4\/markets<\/code> and drop anything that does not match.<\/p>\n
legs_expected = MARKET[\"151278\"][\"marketLength\"]   # First Period Result, 3 legs\nquotes = []\nfor slug, book in board[\"bookmakerOdds\"].items():\n    market = book[\"markets\"].get(\"151278\")\n    if not market:\n        continue\n    legs = {}\n    for outcome_id, outcome in market[\"outcomes\"].items():\n        for price in outcome[\"players\"].values():\n            if not price[\"active\"] or not price[\"price\"]:\n                legs = {}\n                break\n            legs[outcome_id] = price[\"price\"]\n    # A partial quote is not a cheap quote. Count the legs before you rank.\n    if len(legs) == legs_expected:\n        quotes.append((slug, sum(1 \/ p for p in legs.values()) - 1,\n                       tuple(sorted(legs.items()))))\n\nquotes.sort(key=lambda q: q[1])\ntuples = {q[2] for q in quotes}\nprint(f\"{len(quotes)} complete quotes, {len(tuples)} distinct price tuples \"\n      f\"({1 - len(tuples) \/ len(quotes):.1%} collapse)\")\nprint(f\"median margin {statistics.median(q[1] for q in quotes):.2%}\")\nfor slug, margin, _ in quotes[:5]:\n    print(f\"  {slug:16} {margin:.2%}\")<\/code><\/pre>\n
57 complete quotes, 15 distinct price tuples (73.7% collapse)\nmedian margin 9.68%\n  inbet            4.76%\n  20bet            7.30%\n  ivibet           7.30%\n  stake            7.30%\n  tonybet          7.30%<\/code><\/pre>\n
Fifty-seven books, fifteen opinions. The dedupe collapse on First Period Result is 73.7%, and on First Period Total 1.5 it reaches 80.8%. Distinct slugs quote byte-identical prices, and cloneOf<\/code> does not flag them, so collapse on the price tuple before you average anything. The same discipline runs through building a consensus line from 350+ bookmakers<\/a>.<\/p>\n
The period board costs more than the full game, and the gap is consistent across the three periods:<\/p>\n
\n\n\n\n\n\n\n\n\n\n\n
Market<\/th>\nperiod<\/code><\/th>\nComplete quotes<\/th>\nMedian margin<\/th>\nTightest<\/th>\n<\/tr>\n<\/thead>\n
151 Winner (incl. overtime and penalties)<\/td>\nresult<\/code><\/td>\n188<\/td>\n5.49%<\/td>\nduel<\/code> 2.89%<\/td>\n<\/tr>\n
153 Regular Time Result<\/td>\nfulltime<\/code><\/td>\n178<\/td>\n7.72%<\/td>\n1xbet<\/code> 3.12%<\/td>\n<\/tr>\n
151287 First Period Total 1.5<\/td>\np1<\/code><\/td>\n78<\/td>\n8.82%<\/td>\ncaesars<\/code> 3.95%<\/td>\n<\/tr>\n
151278 First Period Result<\/td>\np1<\/code><\/td>\n57<\/td>\n9.68%<\/td>\ninbet<\/code> 4.76%<\/td>\n<\/tr>\n
151644 Second Period Result<\/td>\np2<\/code><\/td>\n44<\/td>\n9.87%<\/td>\ninbet<\/code> 4.07%<\/td>\n<\/tr>\n
152010 Third Period Result<\/td>\np3<\/code><\/td>\n44<\/td>\n9.95%<\/td>\ninbet<\/code> 4.15%<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n
A first-period three-way costs about two points of margin over the same fixture’s regular-time three-way and four over the two-way. The spread inside each market is wider still: caesars<\/code> and the two William Hill feeds quote First Period Total at 3.95% against a 8.82% board median. Shop it. Our line-shopping walkthrough<\/a> runs the same comparison across the full catalogue.<\/p>\n
Step 5: Read the Clock Right<\/h2>\n
\/v4\/scores<\/code> returns a periods<\/code> object, and the keys inside it do not all mean the same kind of number. p1<\/code>, p2<\/code> and p3<\/code> are per-period deltas. fulltime<\/code>, overtime<\/code> and result<\/code> are running totals.<\/p>\n
def line(periods, key):\n    p = periods.get(key)\n    return None if p is None else (p[\"participant1Score\"], p[\"participant2Score\"])\n\nplayed = call(\"fixtures\", sportId=15, tournamentId=234,\n              **{\"from\": \"2026-04-05\", \"to\": \"2026-04-13\"})\n\nregulation = overtime_goal = shootout = mismatch = counted = 0\nfor fixture in played:\n    periods = call(\"scores\", fixtureId=fixture[\"fixtureId\"])[\"scores\"][\"periods\"]\n    time.sleep(1.15)\n    if not all(k in periods for k in (\"p1\", \"p2\", \"p3\", \"fulltime\", \"result\")):\n        continue\n    counted += 1\n    # p1, p2 and p3 are per-period deltas. fulltime is the running regulation score.\n    summed = tuple(sum(periods[k][f\"participant{n}Score\"] for k in (\"p1\", \"p2\", \"p3\"))\n                   for n in (1, 2))\n    if summed != line(periods, \"fulltime\"):\n        mismatch += 1\n    if line(periods, \"result\") == line(periods, \"fulltime\"):\n        regulation += 1\n    elif line(periods, \"overtime\") == line(periods, \"result\"):\n        overtime_goal += 1   # someone scored in the extra period\n    else:\n        shootout += 1        # overtime stayed level, the shootout decided it\n\nprint(f\"{counted} played fixtures, {mismatch} where p1+p2+p3 != fulltime\")\nprint(f\"regulation {regulation}, overtime goal {overtime_goal}, shootout {shootout}\")\nprint(f\"past regulation {(overtime_goal + shootout) \/ counted:.1%}\")<\/code><\/pre>\n
63 played fixtures, 0 where p1+p2+p3 != fulltime\nregulation 51, overtime goal 7, shootout 5\npast regulation 19.0%<\/code><\/pre>\n
Across 63 played NHL fixtures from 5 to 12 April 2026 the three period deltas summed to the regulation score every single time. That gives you two free consistency checks. Sum the periods and compare against fulltime<\/code> before you trust a scoreline. Then diff result<\/code> against overtime<\/code>: when they match, somebody scored in the extra period; when overtime<\/code> still sits level and result<\/code> moved, the shootout decided it. Twelve of the 63 went past regulation, seven on an overtime goal and five in a shootout.<\/p>\n
Step 6: Prove the Grading<\/h2>\n
Take a played fixture and read the period scores next to the settled grid. This is id1500023462079028<\/code> from 5 April 2026.<\/p>\n
MARKET = {str(m[\"marketId\"]): m for m in call(\"markets\")}\nperiods = call(\"scores\", fixtureId=\"id1500023462079028\")[\"scores\"][\"periods\"]\nfor key in (\"p1\", \"p2\", \"p3\", \"fulltime\", \"result\"):\n    score = periods[key]\n    print(f\"  {key:9} {score['participant1Score']}-{score['participant2Score']}\")\n\ngraded = call(\"settlements\", fixtureId=\"id1500023462079028\")[\"markets\"]\nfor market_id in (\"151278\", \"151287\", \"151644\", \"152010\", \"153\", \"151\"):\n    meta = MARKET[market_id]\n    results = {\n        out[\"outcomeName\"]:\n            list(graded[market_id][\"outcomes\"][str(out[\"outcomeId\"])][\"players\"].values())[0][\"result\"]\n        for out in meta[\"outcomes\"]\n    }\n    print(f\"{market_id:8} {meta['period']:9} {meta['marketName'][:22]:22} {results}\")<\/code><\/pre>\n
  p1        1-1\n  p2        0-3\n  p3        2-1\n  fulltime  3-5\n  result    3-5\n151278   p1        First Period Result    {'2': 'LOSE', 'X': 'WIN', '1': 'LOSE'}\n151287   p1        First Period Total     {'Over': 'WIN', 'Under': 'LOSE'}\n151644   p2        Second Period Result   {'X': 'LOSE', '1': 'LOSE', '2': 'WIN'}\n152010   p3        Third Period Result    {'X': 'LOSE', '2': 'LOSE', '1': 'WIN'}\n153      fulltime  Regular Time Result    {'1': 'LOSE', '2': 'WIN', 'X': 'LOSE'}\n151      result    Winner (incl. overtime {'1': 'LOSE', '2': 'WIN'}<\/code><\/pre>\n
Every grade lands on its own period. The first period finished 1-1, so First Period Result pays the draw and First Period Total 1.5 pays the over on two goals. The second period went 0-3, so the away leg wins there, while the home leg wins the third on 2-1. Regular Time Result reads the 3-5 aggregate and Winner reads the same. Five clocks on one fixture, and four of them disagree with the scoreline you would print on a scoreboard.<\/p>\n
The grid holds 634 markets and returns 995 decided outcomes on this fixture. The period markets account for 540 of them, 180 on each of the three periods, against 228 on fulltime<\/code> and 227 on result<\/code>. More than half the graded surface of an NHL fixture sits on the period board.<\/p>\n
Where the Sharp Anchor Is<\/h2>\n
Eleven days out, pinnacle<\/code> and kalshi<\/code> carry no price on the opener. Pass bookmakers=pinnacle<\/code> on its own and you get HTTP 200 with the slug missing from bookmakerOdds<\/code>, which means unpriced rather than gated; a slug that does not exist returns HTTP 400 instead. betfair-ex<\/code> and polymarket<\/code> are on the board but quote full-game markets only, and neither posts a period market. draftkings<\/code> is the one major that does.<\/p>\n
So de-vig the deduped consensus rather than leaning on a sharp reference that has not opened yet. Fifteen distinct tuples across 57 books is a thin sample, and it gets thicker every day as the season approaches. Re-measure on the night.<\/p>\n
Where This Sits Next to the Other Two NHL Traps<\/h2>\n
Hockey holds three market-ID traps. The period board is one. The 118 twin markets<\/a> are the second: every full-game handicap and total ships twice, once settling on regulation and once on the final score, with the same handicap<\/code> value on both. For the third, learn the menu from the puck lines and totals guide<\/a>.<\/p>\n
Read together, the rule is one line: in ice hockey, period<\/code> is the primary key and marketName<\/code> is a label. Basketball splits its result the same way across two market IDs, and you guard it with the same flags you use on the NBA opening-night board<\/a>.<\/p>\n
Going Live<\/h2>\n
Poll \/v4\/odds<\/code> at 10 requests a second on the odds endpoints and 200 a minute elsewhere, or take the WebSocket feed and stop polling. Between periods the first-period board closes and the second-period board opens, so a scheduler that refreshes on a fixed timer will hold a dead price for a full intermission. Track changedAt<\/code> per price and treat a market whose changedAt<\/code> has fallen behind the book’s newest stamp on the fixture as stale.<\/p>\n
One warning for anyone storing this. A book that withdraws a market keeps its last price with active: true<\/code>. The flag tells you the book has not switched the rung off, not that the number is current. Compare timestamps.<\/p>\n
Get Your Key<\/h2>\n
The free tier runs 250 requests a month across every sport and every bookmaker, with no card and no sales call. That covers a whole opening week of NHL period boards. Sign up<\/a>, export the key, and run Step 1 above.<\/p>\n
Historical odds come free as well, so the 63-fixture clock census in Step 5 costs nothing to reproduce on last season’s schedule. If you want the board pushed rather than polled, the WebSocket feed carries the same 225-book payload with resume cursors. The free-tier walkthrough<\/a> has the setup.<\/p>\n
FAQ<\/h2>\n
How do I tell a first-period market from a full-game market?<\/h3>\n
Read the period<\/code> field on \/v4\/markets<\/code>. It returns p1<\/code>, p2<\/code> or p3<\/code> for a single period, fulltime<\/code> for the 60-minute score and result<\/code> for the final score. The market name will not tell you, because First Period Total and Total both read as a totals market and can carry the same handicap<\/code>.<\/p>\n
How many bookmakers price NHL period markets?<\/h3>\n
On Carolina v Florida, measured 18 September 2026 at T-11d, 95 of the 225 bookmakers on the fixture quoted at least one first-period market and 55 quoted all three periods. Forty of them quoted the first period and no other, including bovada.lv<\/code>, hardrockbet<\/code> and bet99<\/code>.<\/p>\n
Do the period scores add up to the full-time score?<\/h3>\n
Yes. Across 63 played NHL fixtures from 5 to 12 April 2026, p1<\/code> plus p2<\/code> plus p3<\/code> equalled the fulltime<\/code> line on all 63. The period keys are deltas; fulltime<\/code>, overtime<\/code> and result<\/code> are running totals.<\/p>\n
How do I detect a shootout from the API?<\/h3>\n
Diff result<\/code> against overtime<\/code> in the \/v4\/scores<\/code> periods object. If they match, a goal in the extra period settled it. If overtime<\/code> still equals fulltime<\/code> while result<\/code> differs, the shootout decided it. Twelve of 63 April fixtures went past regulation, split seven and five.<\/p>\n
What does a first-period market cost in margin?<\/h3>\n
On the opening-night board, First Period Result ran a 9.68% median margin across 57 complete quotes against 7.72% on Regular Time Result and 5.49% on the two-way Winner. Inside the first-period board the spread is wide: caesars<\/code> quoted First Period Total 1.5 at 3.95% against a board median of 8.82%.<\/p>\n
Is the NHL period board available on the free tier?<\/h3>\n
Yes. Every market ID on a fixture comes back in one \/v4\/odds<\/code> call, period markets included, and the free tier allows 250 requests a month with no card. Historical odds and settlements are on the same key.<\/p>\n