Odds API reference

Authorization: Bearer YOUR_API_KEY

RateLimit-Limit: 1000
RateLimit-Remaining: 987
RateLimit-Reset: 42

{
  "homeScore": 54, "awayScore": 49,
  "period": 3, "periodName": "3rd Quarter", "inningHalf": null,
  "clock": "7:12", "clockRunning": true,
  "isPeriodEnd": false, "isTimeout": false,
  "status": "3Q", "periodScores": { "p1": { "home": 28, "away": 22 } },
  "gameScore": null, "updatedMs": 1771540233512
}

{
  "leagues": [
    { "league": "NBA", "sport": "basketball", "kind": "games", "games": 11, "liveGames": 3 },
    { "league": "NBA Futures", "sport": "basketball", "kind": "futures", "games": 6, "liveGames": 0 }
  ]
}

{
  "sportsbooks": [
    { "name": "FanDuel", "category": "sportsbook" },
    { "name": "Pinnacle", "category": "sportsbook" },
    { "name": "NoVigApp", "category": "exchange" },
    { "name": "Kalshi", "category": "prediction" },
    { "name": "PrizePicks", "category": "dfs" }
  ]
}

{
  "league": "NBA",
  "games": [
    {
      "gameId": "ODDS:NBA:GAME:Boston_Celtics:Miami_Heat:1771538400",
      "league": "NBA", "sport": "basketball", "kind": "games", "leagueName": null,
      "homeTeam": "Boston Celtics", "awayTeam": "Miami Heat",
      "startInt": 1771538400, "startTime": "2026-02-19T00:00:00.000Z",
      "isLive": false, "sportsbooks": ["DraftKings", "FanDuel", "Pinnacle"],
      "selections": 1834, "live": null
    }
  ]
}

curl -H "Authorization: Bearer $API_KEY" \
  "https://enterprise.propprofessor.com/v1/odds?gameIds=ODDS:NBA:GAME:Boston_Celtics:Miami_Heat:1771538400&markets=Moneyline,Spread"

{
  "games": [
    {
      "gameId": "ODDS:NBA:GAME:Boston_Celtics:Miami_Heat:1771538400",
      "league": "NBA", "homeTeam": "Boston Celtics", "awayTeam": "Miami Heat",
      "isLive": false, "startInt": 1771538400, "startTime": "2026-02-19T00:00:00.000Z",
      "sport": "basketball", "kind": "games", "leagueName": null,
      "sportsbooks": ["DraftKings", "FanDuel"], "selections": 1834, "live": null,
      "odds": [
        { "id": "FanDuel:Moneyline:Boston_Celtics", "sportsbook": "FanDuel", "market": "Moneyline",
          "selection": "Boston Celtics", "odds": -180, "line": null, "liquidity": 0, "updatedMs": 1771337463308 },
        { "id": "FanDuel:Spread:Miami_Heat_+4.5", "sportsbook": "FanDuel", "market": "Spread",
          "selection": "Miami Heat +4.5", "odds": -110, "line": 4.5, "liquidity": 0, "updatedMs": 1771337460102 }
      ]
    }
  ],
  "missing": []
}

{
  "league": "NBA",
  "markets": [
    { "market": "Player Points", "selections": 4210, "sportsbooks": ["DraftKings", "FanDuel", "PrizePicks", "Underdog"] },
    { "market": "Moneyline", "selections": 396, "sportsbooks": ["BetMGM", "Caesars", "DraftKings", "FanDuel", "Pinnacle"] }
  ]
}

{
  "server": { "version": "2.0.0", "uptimeSec": 86213, "timeMs": 1771540233512 },
  "leagues": {
    "NBA": {
      "active": true, "games": 11, "liveGames": 3,
      "sportsbooks": { "FanDuel": "online", "DraftKings": "online", "BallyBet": "offline" },
      "stream": { "lastEventMs": 1771540233401, "lastSnapshotMs": 1771540200114, "eventsApplied": 8812304 }
    },
    "NFL": { "active": true, "games": 0, "liveGames": 0, "sportsbooks": {}, "stream": { "lastEventMs": null, "lastSnapshotMs": 1771540200114, "eventsApplied": 0 } }
  }
}

{ "type": "hello", "version": "2.0.0", "maxSubscriptions": 25 }

{ "action": "subscribe", "id": "nba-mains", "league": "NBA", "markets": ["Moneyline", "Spread", "Total"] }

{ "action": "subscribe", "id": "two-games",
  "gameIds": ["ODDS:NBA:GAME:Boston_Celtics:Miami_Heat:1771538400", "ODDS:NFL:GAME:Kansas_City_Chiefs:Buffalo_Bills:1771545600"],
  "sportsbooks": ["Pinnacle", "DraftKings", "FanDuel"] }

{
  "type": "snapshot", "id": "nba-mains", "seq": 1,
  "games": [
    { "gameId": "ODDS:NBA:GAME:Boston_Celtics:Miami_Heat:1771538400", "league": "NBA", "isLive": false,
      "homeTeam": "Boston Celtics", "awayTeam": "Miami Heat", "startInt": 1771538400, "startTime": "2026-02-19T00:00:00.000Z",
      "sport": "basketball", "kind": "games", "leagueName": null, "sportsbooks": ["DraftKings", "FanDuel"], "selections": 1834, "live": null,
      "odds": [ { "id": "FanDuel:Moneyline:Boston_Celtics", "sportsbook": "FanDuel", "market": "Moneyline", "selection": "Boston Celtics",
                  "odds": -180, "line": null, "liquidity": 0, "updatedMs": 1771337463308 } ] }
  ]
}

{
  "type": "update", "id": "nba-mains", "seq": 2,
  "gameId": "ODDS:NBA:GAME:Boston_Celtics:Miami_Heat:1771538400",
  "upserts": [ { "id": "FanDuel:Moneyline:Boston_Celtics", "sportsbook": "FanDuel", "market": "Moneyline", "selection": "Boston Celtics",
                 "odds": -190, "line": null, "liquidity": 0, "updatedMs": 1771337470891 } ],
  "removals": [ "DraftKings:Moneyline:Miami_Heat" ]
}

{ "type": "game", "id": "nba-mains", "seq": 3, "event": "added",
  "game": { "gameId": "ODDS:NBA:GAME:LA_Lakers:Denver_Nuggets:1771545600", "league": "NBA", "isLive": false, "…": "…" } }

{ "type": "unsubscribed", "id": "nba-mains" }
{ "type": "pong", "timeMs": 1771540233512 }
{ "type": "error", "id": "nba-mains", "code": "invalid_league", "message": "Unknown league: NBAA" }

{ "action": "unsubscribe", "id": "nba-mains" }
{ "action": "ping" }

export API_KEY=...
BASE=https://enterprise.propprofessor.com

curl -H "Authorization: Bearer $API_KEY" $BASE/v1/leagues
curl -H "Authorization: Bearer $API_KEY" "$BASE/v1/games?league=NFL&live=true"
curl -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
     -d '{"league":"NFL","markets":["Spread"],"sportsbooks":["Pinnacle","DraftKings"]}' \
     $BASE/v1/odds

import WebSocket from "ws";

const ws = new WebSocket("wss://enterprise.propprofessor.com/v1/ws", {
  headers: { Authorization: `Bearer ${process.env.API_KEY}` },
});
const board = new Map(); // gameId -> Map(selectionId -> selection)

ws.on("open", () => {
  ws.send(JSON.stringify({ action: "subscribe", id: "nba", league: "NBA", markets: ["Moneyline", "Spread", "Total"] }));
});

ws.on("message", (raw) => {
  const msg = JSON.parse(raw);
  if (msg.type === "snapshot") {
    board.clear();
    for (const g of msg.games) board.set(g.gameId, new Map(g.odds.map((s) => [s.id, s])));
  } else if (msg.type === "update") {
    const sels = board.get(msg.gameId) ?? new Map();
    for (const s of msg.upserts) sels.set(s.id, s);
    for (const id of msg.removals) sels.delete(id);
    board.set(msg.gameId, sels);
  } else if (msg.type === "game" && msg.event === "removed") {
    board.delete(msg.game.gameId);
  }
});

import asyncio, json, os, websockets

URL = "wss://enterprise.propprofessor.com/v1/ws"
HEADERS = {"Authorization": f"Bearer {os.environ['API_KEY']}"}

async def main():
    async with websockets.connect(URL, additional_headers=HEADERS) as ws:
        await ws.send(json.dumps({"action": "subscribe", "id": "nfl", "league": "NFL",
                                  "sportsbooks": ["Pinnacle", "DraftKings", "FanDuel"]}))
        expected = {}
        async for raw in ws:
            msg = json.loads(raw)
            if "seq" in msg:
                if expected.get(msg["id"], msg["seq"]) != msg["seq"]:
                    raise RuntimeError("gap — resubscribe")
                expected[msg["id"]] = msg["seq"] + 1
            if msg["type"] == "update":
                for sel in msg["upserts"]:
                    print(sel["sportsbook"], sel["market"], sel["selection"], sel["odds"])

asyncio.run(main())