1. Betting data
Playbook-API
  • Global
    • Overview
    • Base URL (Servers)
    • Authentication
    • Rate Limits + Usage
    • Errors
    • League / sportKey Conventions
    • Support
  • Core Endpoints
    • Health
      GET
    • Me
      GET
    • Teams
      GET
    • Live Scores/Games
      GET
    • Team Stats
      GET
    • Injuries
      GET
    • Splits
      GET
    • Splits (Historical/History)
      GET
    • Odds-Games
      GET
    • Lines
      GET
    • Games
      GET
    • Recent Form
      GET
    • Head-to-Head
      GET
  • MLB
    • Pitcher Stats (Season)
      GET
    • Starting Pitchers
      GET
    • Ballpark Weather
      GET
    • Strikeout Predictor
      GET
    • MLB Starting Pitchers
      GET
    • MLB Strikeout Predictor
      GET
    • MLB Pitcher Stats
      GET
    • MLB Ballpark Weather
      GET
  • NFL
    • Roster
    • NFL Team Stats
    • Team vs. Opponent
    • Player vs. Opponent
    • NFL Rosters
    • NFL Team Stats
    • NFL Team vs. Opponent
    • NFL Player vs. Opponent
    • NFL Stadiums
    • NFL IR & Reserve Moves
  • Games & odds
    • Games & IDs
    • Game Lines
    • Games
    • Live Games
  • Player props
    • Player Props
    • Player Prop Splits
  • Betting data
    • Betting Splits
      GET
    • Betting Splits History
      GET
    • Large Wagers
      GET
    • Large Wagers Summary
      GET
  • Injuries & teams
    • Injuries
    • Teams
    • Team Stats
  • Form & matchups
    • Recent Form
    • Head-to-Head
  • NBA
    • NBA Roster Moves
  • Account
    • Account & Usage
  • Schemas
    • Error
  1. Betting data

Large Wagers

GET
/v1/large-wagers
Last modified:2026-10-16 02:10:05
Real-money wagers at or above a dollar amount you choose, on the moneyline and main spread and total, pregame and live. To get only new wagers, send each response's checkpoint back as after (every 5 minutes is plenty), or pull a past date or one game. Kept 30 days. Starter plan and above.
Cost: 1 request unit per call.
Plan: Starter plan and above
How to use it
1.
Pick a league and the smallest wager to include.
2.
Copy the request and run it.
3.
To get only new wagers, send the response's checkpoint as after on the next request.
Notes
amountUsd is the cash the bettor risked; toWinUsd is their profit if the wager wins.
selection is the bet in words: the team on the moneyline ("Chicago Bears"), the team and number on a spread ("Chicago Bears +2.5"), or Over/Under and the number on a total ("Over 45.5").
price is American odds. side is home, away, over or under, for filtering in code; line is the spread or total number for that side (null on the moneyline).
phase is pregame or live, by whether the wager came before the scheduled start.
result is pending until the market settles, then won, lost or push, as the exchange settled it (live wagers too). profitUsd is the bettor's profit or loss: toWinUsd if won, minus amountUsd if lost, 0 on a push, null while pending. Results usually appear within an hour of the final.
Covers each game's moneyline and main spread and total. Wagers on alternate spreads and totals are not included.
Trades on the same side of a market in the same millisecond are combined into one wager, which is almost always one bettor's order filled against several others. price is their size-weighted average.
id is unique per wager. Use it to dedupe if you ever restart polling from an older point.
Player props (kind=props or all) also carry kind: "prop", marketLabel, playerName, playerId and team (both null when the player couldn't be matched with confidence), and side over, under, yes or no. line and selection are exactly what was executed, alternate lines included.
source is the exchange the wager was placed on.
Related: Large Wagers Summary (/v1/large-wagers/summary), Betting Splits (/v1/splits), Game Lines (/v1/lines)

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
API Key
Add parameter in query
api_key
Example:
api_key: ********************
or
Query Params

Responses

🟢200
application/json
Success
Bodyapplication/json

🟠400BadRequest
🟠401Unauthorized
🟠403Forbidden
🟠429RateLimited
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/v1/large-wagers?league=&min=&kind=&market=&gameId=pbk_00ab8e7ef078895e600f&date=&since=&after=&result=&limit=' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "league": "NFL",
    "min": 1000,
    "count": 1,
    "hasMore": false,
    "checkpoint": "YjE5ZjJjMGEuNDgyMQ",
    "data": [
        {
            "id": "lw_3f9a1c27e45b08d6a2c1",
            "source": "novig",
            "league": "NFL",
            "gameId": "pbk_91ec8d2398eb55677b73",
            "homeTeamName": "Green Bay Packers",
            "awayTeamName": "Chicago Bears",
            "startTime": "2026-10-11T17:00:00Z",
            "market": "moneyline",
            "selection": "Chicago Bears",
            "side": "away",
            "line": null,
            "price": 163,
            "amountUsd": 3800,
            "toWinUsd": 6200,
            "result": "won",
            "profitUsd": 6200,
            "phase": "pregame",
            "at": "2026-10-11T15:42:08Z"
        }
    ]
}
Modified at 2026-10-16 02:10:05
Previous
Betting Splits History
Next
Large Wagers Summary
Built with