NEW✦ Build with AI: sports data API, setup guides, and MCP →

Pinnacle odds API · affiliate 3 · REST + WebSocket

Pinnacle odds API.
The sharp line, side by side.

Pinnacle game lines, alternates, periods, props, and futures beside DraftKings, FanDuel, and the rest of the 24 books, with Pinnacle’s max stake in US dollars.

Get a free API keyRead the docs

Free key · 20,000 data points a day · No credit card · Every book and live odds from $49/mo

GET/api/v2/sports/{sport_id}/events/{date}

RequestPython 3 · requests

import os
from datetime import datetime, timezone
import requests

key = os.environ["THERUNDOWN_API_KEY"]
api = "https://therundown.io/api/v2"
headers = {"X-TheRundown-Key": key}

# Next game date across the NFL (2), MLB (3), NBA (4), and NHL (6)
dates = requests.get(
    f"{api}/sports/dates",
    params={
        "sport_ids": "2,3,4,6",
        "format": "epoch",
        "exclude_canceled": "true",
    },
    headers=headers,
    timeout=30,
).json()

now = datetime.now(timezone.utc).timestamp()
upcoming = [
    (sport_id, stamp)
    for sport_id, body in dates.items()
    for stamp in body.get("dates") or []
    if stamp > now
]
sport_id, stamp = min(upcoming, key=lambda row: row[1], default=("2", now))
date = datetime.fromtimestamp(stamp, timezone.utc).date().isoformat()

# Pinnacle next to DraftKings and FanDuel: moneyline, spread, and total
odds = requests.get(
    f"{api}/sports/{sport_id}/events/{date}",
    params={"market_ids": "1,2,3", "affiliate_ids": "3,19,23", "main_line": "true"},
    headers=headers,
    timeout=30,
)
print(odds.text)

Response200 · trimmed

{
  "events": [{
    "event_id": "9cd666660847e644ecea84fc24cf9f58",
    "sport_id": 2,
    "event_date": "2026-10-04T13:30:00Z",
    "markets": [{
      "market_id": 1,
      "name": "moneyline",
      "participants": [{
        "id": 70,
        "type": "TYPE_TEAM",
        "name": "Indianapolis Colts",
        "lines": [{
          "prices": {
            "3": {
              "price": -202,
              "liquidity_usd": 30000,
              "updated_at": "2026-10-03T22:12:48Z"
            },
            "19": { "price": -205, "updated_at": "2026-10-03T14:28:27Z" },
            "23": { "price": -220, "updated_at": "2026-10-03T14:53:59Z" }
          }
        }]
      }]
    }]
  }]
}

Colts at Commanders, October 4, 2026, trimmed to one side of one market. On Pinnacle, liquidity_usd is the max stake.

Starter keyPinnacle needs Starter or above. On a Free key the request still runs and returns DraftKings and FanDuel without Pinnacle.

Markets

Pinnacle beyond the main line.

Pinnacle prices the NFL, NCAAF, NBA, WNBA, MLB, NHL, UFC/MMA, the Premier League, MLS, the Champions League, ATP, and WTA. These are the market types it posts, each beside every other book.

52
Markets priced Oct 4
12
Leagues
USD
Max stake, where posted
3
Affiliate ID
Market typePlan
  • Game linesMoneyline, spread, and total in every league it prices
    1 · 2 · 3Starter
  • Alternate linesAlternate spreads and totals in the NFL, NBA, MLB, and NHL
    omit main_lineStarter
  • PeriodsNFL 1st half and 1st quarter; NHL periods; MLB first five and 1st inning
    4 · 5 · 6 · 981 · 957 · 958 · 1011–1016 · 780 · 791 · 1129Starter
  • Team totalsGame, half, quarter, and period team totals
    94 · 95 · 991 · 1020 · 1021Starter
  • Player propsNFL yards and receptions; NBA points, rebounds, assists, threes, and PRA; NHL goals, shots, points, and assists
    51 · 53 · 57 · 58 · 29 · 35 · 39 · 38 · 93 · 86 · 97Starter
  • Game propsMLB winning margin, correct score, total runs bands, and odd/even; NHL correct score
    9 · 335 · 805 · 799Starter
  • In-gameLive game lines while Pinnacle trades them
    41 · 42 · 43Starter
  • FuturesSuper Bowl, NBA Champion, World Series, and Stanley Cup boards; NFL and NBA MVP; NFL win totals and playoffs
    /sports/{id}/futuresUltra

Market IDs Pinnacle priced on the October 4, 2026 NFL, NBA, MLB, and NHL slates, plus its alternates, in-game lines, and futures. Coverage varies by league and game.

Books

All 24 books. One schema.

Benchmark Pinnacle against 19 sportsbooks, 3 prediction markets, and 2 exchanges in the same response.

24
Books
19
Sportsbooks
3
Prediction markets
2
Exchanges
Books in the API24

Sportsbooks · 19

  • DraftKingsFree19
  • FanDuelFree23
  • BetMGMFree22
  • Pinnacle3
  • Circa Sports32
  • BookMaker7
  • BetCRIS9
  • Bovada2
  • theScore Bet24
  • Unibet21
  • HardRock28
  • Bet10533
  • Heritage Sports34
  • BetOnline6
  • SportsBetting4
  • LowVig11
  • Intertops14
  • Matchbook16
  • YouWager18

Prediction markets · 3

  • Kalshi25
  • Polymarket26
  • Polymarket US31

Exchanges · 2

  • ProphetX29
  • Novig30

Live from GET /api/v2/affiliates. Coverage varies by league, game, and market.

Free vs paid

Test free. Pinnacle starts at $49.

Choose TheRundown for odds and scores joined under one event ID, with participant and signed-line identities and explicit price closure signals. Request the books and markets your application uses, then measure X-Datapoints. Paid subscriptions have a fixed fee and included volume; unrequested price rows conserve that volume without reducing the base fee. Read the sports odds API guide · Explore joined sports data · Metering rules

Free · $0

No Pinnacle. Free keys return DraftKings, FanDuel, and BetMGM, pre-match and five minutes delayed.

Paid · from $49/mo

Pinnacle from $49 a month: 60-second delay on Starter, 30 on Pro, real-time on Ultra.

Free$0/mo5-minute delay · 20,000/day · 200,000/monthPre-match game lines from DraftKings, FanDuel, and BetMGM.
Starter$49/mo60-second delay · 25,000,000/moEligible sources, alternates, periods, props, and 60-second-delayed in-play odds. Internal or personal use.
Pro$149/mo30-second delay · 125,000,000/mo30-second-delayed odds and commercial end-user display.
Ultra$399/moReal-time · 500,000,000/moReal-time REST, WebSocket streaming, and futures.

Compare every plan →

Questions

Before you build.

Plans, markets, books, and IDs for the Pinnacle odds API.

Is Pinnacle on the free plan?
No. Free keys return DraftKings, FanDuel, and BetMGM. Pinnacle starts on Starter ($49 a month) with a 60-second delay. Pro cuts that to 30 seconds, and Ultra is real-time.
Which Pinnacle markets are available?
Game lines in every league Pinnacle prices; alternate spreads and totals in the NFL, NBA, MLB, and NHL; NFL 1st half and 1st quarter, NHL period, and MLB first-five and 1st inning lines; team totals; player props in the NFL, NBA, and NHL; MLB and NHL game props; in-game lines; and futures, including championship boards, NFL and NBA MVP, and NFL win totals. Futures start on Ultra.
What does liquidity_usd mean on a Pinnacle price?
Pinnacle’s max stake for that price, in US dollars. The field is left out when no current reading is available.
Can I get Pinnacle opening and closing lines?
Yes. Opening and closing lines start on Pro ($149 a month). Line history, with every price change timestamped, starts on Starter.
Does Pinnacle still have a public API?
Not for general developers. Pinnacle closed its public API to the general public on July 23, 2025, and now grants access by application to select high-value bettors, commercial partners, and academic or pregame handicapping projects. TheRundown returns Pinnacle game lines, alternates, periods, and props beside every other book from $49 a month, and Pinnacle futures on Ultra ($399 a month).How to get Pinnacle odds after the closure →
What is the Pinnacle affiliate ID?
3. Pass affiliate_ids=3 alone, or add other books to compare them in one response. GET /api/v2/affiliates lists all 24 books.

Benchmark against Pinnacle.

Get a free API keySee API pricing