← Home ⚾ MLB API 🏈 NFL API 🏀 NBA API 🏈 NHL API
Sports APIs
⚡ PropSports API — From $29/mo ⚾ MLB Edge Suite — From $29/mo
Real Estate APIs
🏠 PropData Core — From $49/mo 🏆 PropData Pro Stack — From $149/mo 🏠 PropData API ↗
📖 Docs 💳 Pricing Get API Key →
API v6.1.0

PropSports API documentation

PropSports is a JSON REST API with 244 documented GET routes across MLB, NFL, NBA, WNBA, NHL, tennis, soccer and golf. Live and historical depth depends on each sport and route; the commercial Golf API provides historical and post-round scoring rather than live scoring. Availability and latency depend on the endpoint and source freshness, with no universal sub-100ms guarantee.

PropSports operates data normalization and delivery infrastructure and offers its own baseball-model probabilities through the /mlb/odds/model/* routes. Model probabilities are distinct from external market quotes. Data availability and downstream use remain subject to the source and licensing limits described below.

244 endpoints MLB · NFL · NBA · WNBA · NHL · Tennis · Soccer · Golf JSON only GET requests CORS enabled Cloudflare edge
⚡ What's new — October 2026: Golf joins the core API with 30 routes: championships since 1860, leaderboards and hole-by-hole scorecards. Soccer adds the match event ledger at /soccer/matches/:id/events. MLB has 52 routes, including complete play-by-play, injury and availability history, batter–pitcher matchups, official wild-card standings and published TV broadcasts. 244 core routes across eight sports.

Authentication

Send API keys from your server using the X-API-Key header. The legacy ?key= query parameter remains supported for compatibility, but is not recommended: URLs can be recorded in browser history, analytics, and access logs. Never expose secret keys in public client-side code.

cURL — authenticated
# Header auth (recommended)
curl https://propsports.proptechusa.ai/v1/mlb/schedule/today \
  -H "X-API-Key: your_api_key_here"

JavaScript
const BASE = 'https://propsports.proptechusa.ai/v1';
const KEY  = 'your_api_key_here';

const data = await fetch(`${BASE}/mlb/schedule/today`, {
  headers: { 'X-API-Key': KEY }
}).then(r => r.json());

console.log(data.games);
Python
import requests

BASE = "https://propsports.proptechusa.ai/v1"
KEY  = "your_api_key_here"

r = requests.get(f"{BASE}/mlb/schedule/today", headers={"X-API-Key": KEY})
data = r.json()
print(data["games"])

Base URL & Headers

Base URL
https://propsports.proptechusa.ai/v1
HeaderValueNotes
X-API-Keyyour_keyRequired for all key-gated sports endpoints; MLB schedule, live scoreboard and MiLB catalog stay public
Content-TypeNot requiredAll responses are JSON regardless
OriginAnyCORS enabled — all origins allowed
💡 Inspect each response's Cache-Control. Public routes may be cacheable, while authenticated or rights-restricted routes can return private, no-store. Refresh and source-update intervals vary; do not assume a universal cache TTL. HTTP caching is separate from the contractual retention license.

Rate Limits

PlanDaily RequestsSportsPrice
Single Sport50,000One selected sport$29/mo
Developer100,000Up to 3 selected sports$79/mo
All Sports200,000All 8 core sports$149/mo
Pro500,000All 8 core sports$299/mo
Scale2,000,000All 8 core sports$599/mo
Enterprise5,000,000All 8 core sports$1,500/mo

Daily counters roll over on the US Eastern calendar date. Rate limit exceeded returns 429 with a JSON error body.

Public schedules and MiLB metadata; paid intelligence. Production access requires a paid PropSports API key. Plans start at $29/mo for one sport (50,000 req/day); all 8 core sports from $149/mo.

Errors & Status Codes

All errors return a JSON body with an error field, an optional hint, and links to docs and pricing.

Error response shape
{
  "error":   "Invalid API key.",
  "hint":    "Get a key at propsports.proptechusa.ai/pricing.html",
  "docs":    "https://propsports.proptechusa.ai/docs.html",
  "pricing": "https://propsports.proptechusa.ai/pricing.html"
}
StatusMeaning
200OK
400Bad request — missing or invalid parameter
401Invalid or missing API key
403Your plan does not include this sport or endpoint
404Endpoint not found — check the path
429Request limit exceeded
500Internal server error; retry according to your application policy

Data principles & methodology

The sporting event is the subject. The intelligence is our work. PropSports collects, organizes, verifies, and analyzes factual sports information. We do not claim ownership of the sporting events we cover.

Our contribution is the historical record we assemble, the systems we build to reconcile information, and the software and original intelligence we develop around it.

For integrations, distinguish observed facts from model outputs; use the timestamps and coverage information available on each route; and treat missing values as unknown, not zero. A response time is not necessarily the time an underlying observation changed.

Read our data principles and methodology → for identity matching, freshness, corrections, historical context, and how to report a concern. The data contract and commercial-use terms below remain the reference for API behavior and permitted use.

Data contract

PropSports provides the API contract and normalizes available sports data. The data_source field identifies the PropSports API response; it does not assert ownership of every underlying record.

Compatibility fields. Existing responses may carry source, source.provider, source_urls, source_url, roster_url, provider, source_route, or source-specific IDs such as espn_*. These keys and identifiers remain supported for existing integrations. Where supplied, deprecated_fields and deprecation_note describe their migration status. Use the documented PropSports route IDs for new integrations and preserve source attribution or rights metadata in downstream displays where required.

Contract fields
{
  "data_source":       "PropSports",
  "deprecated_fields": ["source_urls"],
  "deprecation_note":  "See the response for migration details"
}

Commercial use & licensing scope

PropSports provides sports-data collection, normalization, identity resolution, API delivery and proprietary analytical infrastructure. Paid subscriptions authorize access to the Service and permitted API outputs within the plan and standard Terms; they are not blanket licenses to third-party intellectual property.

Building a commercial application

Use permitted factual API outputs in commercial apps within your plan, subject to applicable source restrictions, attribution, temporary caching and historical retention limits, and any required third-party permissions. Check the historical-storage terms before retaining full game records or republishing source material. API access alone does not authorize all protected play descriptions, media, logos, likenesses, broadcasts or footage.

Official rights and documentation

Standard subscriptions do not include league-issued certificates, custom licensing warranties, legal opinions, sublicensing rights or guarantees of App Store approval. If your project requires official league-backed data or media permissions, contact the relevant rights holder or an authorized distributor. Any broader rights must be expressly documented by an authorized rights grantor.

Attribution and source rights

Underlying factual records, marks, imagery and media may have separate owners and usage restrictions. Preserve attribution and licensing fields returned by the API, including image credits and source-specific restrictions. API access does not transfer those rights. See Third-Party Intellectual Property for the applicable terms.

Standard-plan evaluation: Self-service subscriptions use the published documentation, route reference, representative response excerpts and standard Terms. Internal QA archives, upstream supplier agreements and custom legal warranties are not included with a self-service evaluation. Additional diligence, where available, must be scoped through a separate Enterprise agreement.

Read before subscribing: Permitted Use · Historical Storage · Third-Party Intellectual Property.

Historical data

Historical records use the same routes, key and plan as current data. Pass a game ID for game routes, ?season=YYYY for season-scoped routes such as standings and team schedules, and ?date=YYYY-MM-DD for date-scoped schedules. Spans below are verified through customer routes as of 2026-10-19; see Coverage & methodology for depth, delivery and known gaps.

SportVerified spanLayers
MLB1939–2026Play-by-play (1950–2026) /mlb/game/:pk/plays?full=true
Box scores (1950–2026) /mlb/game/:pk/boxscore
Standings by season (1950–2026) /mlb/standings?season=
Player careers (1939–2026) /mlb/player/:id/career
Minor-league archive (2021–2026) /mlb/minors/scores
NFL1999–2026Schedules and final scores (1999–2026) /nfl/schedule?season=&week=
Play-by-play (2001–2026) /nfl/game/:id/plays
NBA1994–2026Box scores (1994–2026) /nba/game/:id/boxscore
Play-by-play (2002–2026) /nba/game/:id/plays
WNBA2002–2026Schedules and results (2002–2026) /wnba/schedule?season=
Play-by-play (2002–2026) /wnba/games/:id/events
NHL1917–2026Leaders by season (1917–2026) /nhl/leaders?season=
Schedules and final scores (1985–2026) /nhl/schedule?date=
Goal and penalty events (1917–2026) /nhl/game/:id/plays
Shots on goal (1997–2026) /nhl/game/:id/plays
Full event stream (2009–2026) /nhl/game/:id/plays
Tennis2000–2026Match archive (2000–2026) /tennis/h2h/:a/:b
Men's tour results (2007–2026) /tennis/men
Point-by-point (2026–2026) /tennis/pbecast/:id
Soccer2001–2026Match results (2001–2026) /soccer/matches
Goal and match events (2009–2026) /soccer/matches/:id
Event ledger: full event streams (2017–2018) /soccer/matches/:id/events
Event ledger: goal events (2009–2026) /soccer/matches/:id/events
Lineups and player stats (2017–2026) /soccer/matches/:id/cast
Golf1860–2026Champions (1860–2026) /golf/tournaments
Leaderboards and round scores (2000–2026) /golf/tournaments/:edition/leaderboard
Hole-by-hole scores (2000–2026) /golf/tournaments/:edition/scorecards
Players and courses (1860–2026) /golf/players/:player/results
UFC1993–2026Events and bouts (1993–2026) /v1/ufc/events
Round statistics (1994–2026) /v1/ufc/bouts/:id/stats

Example: one historical request

curl -H "X-API-Key: $PROPSPORTS_KEY" "https://propsports.proptechusa.ai/v1/mlb/game/151570/plays?full=true"

Stored archive — Materialized in PropSports storage and served from it. Counts are rows we hold and serve. On-demand source — Retrieved from the public league or source feed when you call the route, then normalized into the PropSports contract. It is not a PropSports-owned archive: availability follows the source, and no row count is claimed. The source’s own terms of use apply; a PropSports plan does not grant redistribution rights to on-demand data.

MLB Injury, Player and Broadcast Intelligence

Published in October 2026. All routes use https://propsports.proptechusa.ai/v1. Schedules and the live scoreboard remain public; player profiles, detailed game data, standings and injury intelligence require an MLB-entitled X-API-Key. Minor-league factual routes remain public.

Injury / availability

GET /mlb/injuries/current returns the current official 40-man IL population and episode metadata. GET /mlb/injuries/coverage supplies coverage, freshness, attribution, unsupported fields and provenance. GET /mlb/player/:id/availability and GET /mlb/player/:id/injury-history provide player-specific availability and dated episodes. GET /mlb/rehab/stints?player_id=681481 filters rehab records by MLBAM player ID. Known unknowns remain null; current IL is not artificially limited to the last 30 days of transactions.

Player / batter-pitcher intelligence

GET /mlb/matchups/batter-pitcher?batter_id=681481&pitcher_id=605141 returns both players with bats, throws and primary_position, the published head-to-head record and the batter-vs-pitcher-hand split, when available. GET /mlb/player/:id/career returns season-by-season career lines (careers from 1939).

Schedules / TV broadcast listings

GET /mlb/team/111/schedule?season=2027&game_types=all includes all published game types, game IDs, opponents, status, doubleheaders, rescheduled games, probable pitchers and source-provided broadcasts and tv_broadcasts. GET /mlb/schedule?date=2026-06-10 returns date-based broadcasts. A null listing means the source did not supply broadcast data; an empty list means no listings in the source.

Official standings / complete game reconstruction

GET /mlb/standings?season=2026 publishes both division standings and source-ordered wild_card_leagues, including available ranks and clinch codes. Missing clinch codes do not imply elimination. GET /mlb/game/849812/plays?full=true returns a complete chronological plays array with total; omitting full=true preserves the recent-plays response.

Freshness and rights

Consult response Cache-Control headers per endpoint; full play-by-play uses a five-second response cache and data refresh timing still applies. Roster IL status is scheduled every three hours and recent transactions every ten minutes. Video page indexing, embedded playback and radio streaming are separate media products, not included in these structured MLB data routes.

Browse all 52 MLB routes in the API reference.

Route catalog

The production catalog has 244 documented routes across MLB, NFL, NBA, WNBA, NHL, Tennis, Soccer and Golf. Every route is listed in the API reference, and the machine-readable route catalog is available at GET /sports. GET /health reports the same total.

SportRoutes
MLB52
NFL36
NBA19
WNBA32
NHL24
Tennis25
Soccer26
Golf30
All sports244

Use the sport guides for examples, response shapes and implementation notes. Plans determine which sports are included on your API key.

How routes are counted

A route is one documented GET path template: /mlb/game/:pk/plays counts once and serves every game from 1950 to tonight. Operational routes (/health, /ping, /sports) are not counted.

  • Core PropSports API: 244 routes across eight sports. These are the routes a PropSports key can be entitled to, by plan. GET /health and GET /sports report the same total.
  • UFC Intelligence API: 40 commercial routes. A separate product with its own subscription and key, listed in its OpenAPI document. A PropSports key does not include UFC.
  • Network: 284 documented routes across nine sports (both products combined).
⚡ Proprietary — No Competitor Offers This

GET /mlb/odds/model

GET/mlb/odds/model

All PropBetEdge Poisson model odds for today. Grouped by market. Generated from owned Statcast data — no DraftKings, no FanDuel dependency. Refreshed 6× daily: 8AM, 10AM, 12PM, 2PM, 5PM, 8PM CT.

ParamTypeRequiredDescription
marketstringoptionalFilter by market: hr, totalbases, hits, strikeouts, rbi, runs
playerstringoptionalFilter by player name substring. e.g. Soto
directionstringoptionalOVER or UNDER
Response
{
  "date": "2026-06-09",
  "source": "PropBetEdge Poisson Model",
  "model": "Statcast xSLG + barrel% + EV allowed + park factor",
  "total": 184,
  "markets": {
    "hr": [ ... ],
    "totalbases": [ ... ],
    "hits": [ ... ]
  },
  "top_value": [
    {
      "player_name": "Aaron Judge",
      "market": "hr",
      "line": 0.5,
      "direction": "OVER",
      "expected_stat": 0.38,
      "implied_prob": 0.314,
      "odds_fmt": "+310"
    }
  ]
}

GET /mlb/odds/model/top

GET/mlb/odds/model/top

Top OVER value plays for today ranked by expected stat. Returns only positive-odds plays (implied prob < 50%). The fastest way to surface model edges.

ParamTypeRequiredDescription
limitintegeroptionalMax results. Default: 20. Max: 200.
marketstringoptionalFilter to one market. Default: all markets.
JavaScript
const plays = await fetch(
  'https://propsports.proptechusa.ai/v1/mlb/odds/model/top?limit=10',
  { headers: { 'X-API-Key': KEY } }
).then(r => r.json());

plays.plays.forEach(p => {
  console.log(`${p.player_name} ${p.market} OVER ${p.line} → ${p.odds_fmt}`);
});

GET /mlb/odds/model/player

GET/mlb/odds/model/player

All model markets for a single player. Returns HR, total bases, hits, strikeouts, RBI, and runs in one call.

ParamTypeRequiredDescription
namestringrequiredPlayer name substring. e.g. Soto or Aaron Judge
cURL
curl "https://propsports.proptechusa.ai/v1/mlb/odds/model/player?name=Soto" \
  -H "X-API-Key: your_key"

GET /mlb/odds/hr

GET/mlb/odds/hr

Home run props from DraftKings and FanDuel, merged and ranked by best line. No sportsbook key required.

ParamTypeRequiredDescription
namestringoptionalFilter by player name substring
directionstringoptionalOVER or UNDER
Response
{
  "date": "2026-06-09",
  "market": "home_runs",
  "dk_count": 72,
  "fd_count": 68,
  "count": 86,
  "source": "DraftKings + FanDuel",
  "results": [
    {
      "player": "Aaron Judge",
      "market": "hr",
      "line": 0.5,
      "direction": "OVER",
      "best_book": "DraftKings",
      "best_odds": 310,
      "best_odds_fmt": "+310",
      "all_books": {
        "DraftKings": { "odds": 310, "odds_fmt": "+310" },
        "FanDuel":   { "odds": 290, "odds_fmt": "+290" }
      }
    }
  ]
}

GET /mlb/odds/totalbases

GET/mlb/odds/totalbases

Total bases props. DK + FanDuel merged. Same response shape as /mlb/odds/hr. Params: name, direction.

GET /mlb/odds/hits

GET/mlb/odds/hits

Hits props. DK + FanDuel merged. Params: name, direction.

GET /mlb/odds/strikeouts

GET/mlb/odds/strikeouts

Pitcher strikeout props. DK + FanDuel merged. Params: name, direction.

GET /mlb/odds/rbi

GET/mlb/odds/rbi

RBI props. DK + FanDuel merged. Params: name, direction.

GET /mlb/odds/all

GET/mlb/odds/all

All book prop markets (HR, total bases, hits, strikeouts) in a single response. Grouped by market key. Optional name filter applies to all markets.

GET /mlb/odds/player

GET/mlb/odds/player

All book markets for a single player. ?name=Soto returns HR, total bases, hits, and strikeouts from DK + FanDuel.

ParamTypeRequired
namestringrequired

GET /mlb/odds

GET/mlb/odds

Available game-level MLB spread, total and moneyline for today's games.

GET /mlb/schedule/today

GET/mlb/schedule/today

Today's MLB slate with available probable pitchers, venue, teams and linescore.

Response shape
{
  "date": "2026-06-09",
  "games": [
    {
      "gamePk": 747892,
      "gameDate": "2026-06-09T18:10:00Z",
      "status": { "abstractGameState": "In Progress" },
      "teams": {
        "away": { "team": { "name": "New York Yankees" }, "score": 4,
                  "probablePitcher": { "fullName": "Gerrit Cole" } },
        "home":  { "team": { "name": "Boston Red Sox" }, "score": 2,
                  "probablePitcher": { "fullName": "Brayan Bello" } }
      },
      "venue": { "name": "Fenway Park" }
    }
  ]
}

GET /mlb/schedule

GET/mlb/schedule

Schedule for any date.

ParamTypeRequiredDescription
datestringoptionalYYYY-MM-DD. Defaults to today ET.

GET /mlb/games/live

GET/mlb/games/live

All MLB games currently in progress with live linescore. Returns an empty array when no games are live.

GET /mlb/lineups

GET/mlb/lineups

Confirmed batting lineups when posted. Probable pitcher + lineup array for both teams.

ParamTypeRequiredDescription
datestringoptionalYYYY-MM-DD. Defaults to today ET.

GET /mlb/game/:gamePk/linescore

GET/mlb/game/:gamePk/linescore

Inning-by-inning linescore for any game. gamePk from /mlb/schedule.

GET /mlb/game/:gamePk/boxscore

GET/mlb/game/:gamePk/boxscore

Full boxscore. Hitting and pitching lines for both teams including all standard stats.

GET /mlb/game/:gamePk/plays

GET/mlb/game/:gamePk/plays

Play-by-play. Returns most recent N plays.

ParamTypeRequiredDescription
limitintegeroptionalNumber of recent plays to return. Default: 20.

GET /mlb/player/:id/stats

GET/mlb/player/:id/stats

Season stats by MLB player ID.

ParamTypeRequiredDescription
groupstringoptionalhitting (default) or pitching
seasonintegeroptional4-digit year. Defaults to current season.

GET /mlb/player/:id/gamelog

GET/mlb/player/:id/gamelog

Game-by-game log for any player. Full split history per appearance.

GET /mlb/statcast/batters

GET/mlb/statcast/batters

Statcast batter leaderboard with available exit velocity, barrel rate and expected hitting metrics. Check response timestamps for freshness.

FieldTypeDescription
avgEVfloatAverage exit velocity (mph)
maxEVfloatMaximum exit velocity in season
hardHitPctfloatHard hit rate — 95+ mph
barrelPctfloatBarrel rate percentage
xBA / xSLG / xwOBAfloatExpected BA, SLG, wOBA from Statcast
sprintSpeedfloatSprint speed ft/s
l7HR / l7EVfloatLast-7-day HR count and average EV
evSpikefloatl7EV minus season avgEV — positive = trending up
hrStreakintegerConsecutive games with HR
gamesWithoutHRintegerConsecutive games without HR
vsRHPobjectHR, PA, avgEV vs right-handed pitchers
vsLHPobjectHR, PA, avgEV vs left-handed pitchers
batsstringL, R, or S
📈 TTL: 900s. This endpoint caches for 15 minutes; check response timestamps for data freshness.

GET /mlb/statcast/pitchers

GET/mlb/statcast/pitchers

PropTechUSA owned Statcast for the complete current-season pitcher dataset. EV allowed, barrel rate, hard hit rate, average and recent velo, velo drop detection, pitch mix, HR rate, and sample size. Returns all current-season pitchers by default; use ?limit= and ?offset= for pagination.

FieldTypeDescription
avgEVAllowedfloatAverage EV allowed this season
barrelRateAllowedfloatBarrel rate allowed %
hrsAllowedintegerHR allowed this season
paPerHRfloatPA per HR allowed — lower = more homer-prone
avgVelofloatAverage fastball velocity
recentVelofloatRecent 3-start velo average
veloDownbooleanTrue if recent velo significantly below season avg
pitchMixobjectPitch type percentages
sampleSizeintegerPA in dataset

GET /mlb/weather

GET/mlb/weather

Real-time weather for a single ballpark. Indoor parks (Tropicana, Rogers Centre, Globe Life, Chase, LoanDepot, Minute Maid, American Family) return "indoor": true.

ParamTypeRequiredDescription
parkstringrequiredExact park name e.g. Fenway Park, Yankee Stadium
Response
{
  "indoor": false,
  "park": "Fenway Park",
  "parkFactor": 104,
  "windSpeed": 12.4,
  "windDir": 220,
  "windLabel": "SW",
  "temp": 71
}

GET /mlb/weather/all

GET/mlb/weather/all

Weather for every ballpark hosting a game today (or on the specified date). One call for all parks.

ParamTypeRequired
datestringoptional — YYYY-MM-DD

GET /mlb/umpires

GET/mlb/umpires

Home plate umpire assignments for today's games. Combine with your own K-rate data for umpire angle plays.

ParamTypeRequired
datestringoptional — YYYY-MM-DD

GET /nfl/schedule

GET/nfl/schedule

NFL schedule. Defaults to the current week. Returns available spread, total, venue and score for each game.

ParamTypeRequiredDescription
weekintegeroptionalWeek number 1–18
seasonintegeroptional4-digit year

GET /nfl/games/live

GET/nfl/games/live

All NFL games currently in progress.

GET /nfl/odds

GET/nfl/odds

Game-level NFL odds. Spread, over/under, home and away moneyline. Filters out games without odds.

GET /nfl/scoreboard

GET/nfl/scoreboard

Normalized NFL scoreboard by date or week. Returns teams, score, status, venue, broadcast context, current situation and game-level odds when available.

ParamTypeRequiredDescription
dateYYYYMMDDoptionalScoreboard date. Defaults to the current Eastern date.
weekintegeroptionalNFL week. When supplied, week mode takes precedence over date.
seasonintegeroptionalNFL season year. Defaults to the current year.
season_typeintegeroptionalSeason phase. Defaults to 2 for regular season.

GET /nfl/standings

GET/nfl/standings

Current NFL standings normalized into all eight division groups with team metadata and provider-supplied standings statistics.

GET /nfl/teams

GET/nfl/teams

NFL team directory with stable IDs, abbreviations, names, logos, colors, active status and links. Use the returned IDs in team routes.

GET /nfl/team/:id

GET/nfl/team/:id

Normalized profile for one NFL team. Use the team ID returned by /nfl/teams.

GET /nfl/team/:id/roster

GET/nfl/team/:id/roster

Current roster with player IDs, names, jersey, position, headshot, age, height, weight, experience, and roster status when supplied upstream.

GET /nfl/team/:id/schedule

GET/nfl/team/:id/schedule

Team-specific event schedule with event IDs, dates, names, season/week references, competition references, and links.

ParamTypeRequiredDescription
seasonintegeroptionalSeason year.

GET /nfl/game/:id

GET/nfl/game/:id

Normalized game package: teams, score, status, venue, possession, down-and-distance, drives, play-by-play, player statistics, leaders and available win probability. Use a game ID returned by the schedule or scoreboard routes.

GET /nfl/game/:id/boxscore

GET/nfl/game/:id/boxscore

Player box-score groups and labels for both teams. Fields remain source-aware rather than inventing missing statistics.

GET /nfl/game/:id/plays

GET/nfl/game/:id/plays

Play-by-play with period, clock, field position, down-and-distance, participants, scoring state, and score context.

GET /nfl/game/:id/drives

GET/nfl/game/:id/drives

Drive history with offense, result, yards, play count, elapsed time, start/end field position, and contained plays.

GET /nfl/game/:id/leaders

GET/nfl/game/:id/leaders

Passing, rushing, and receiving game leaders. If the provider omits a leader block, PropSports derives leaders only from factual box-score yardage.

GET /nfl/game/:id/winprob

GET/nfl/game/:id/winprob

Provider-supplied game win-probability series keyed to play IDs. Returns an empty series when the upstream game package does not supply win probability.

GET /nba/schedule/today

GET/nba/schedule/today

Today's NBA games. Playoff-aware — tries the playoff schedule first, falls back to regular season. Returns status, score, period, clock, team logos, spread, and over/under.

GET /nba/games/live

GET/nba/games/live

All NBA games with status.type.state === "in".

GET /nba/game/:id/boxscore

GET/nba/game/:id/boxscore

Full boxscore with computed True Shooting % (TS%) and Usage Rate (USG%) per player. Most APIs return raw stats and leave the math to you. We do the math.

Response shape (player)
{
  "name": "Jayson Tatum",
  "points": 34, "rebounds": 9, "assists": 6,
  "fgMade": 12, "fgAttempts": 22, "fgPct": 54.5,
  "tsPct": 68.4,   // True Shooting % — computed
  "usgPct": 34.1,  // Usage Rate % — computed
  "minutes": 38, "plusMinus": 12
}

GET /nba/game/:id/plays

GET/nba/game/:id/plays

Play-by-play with event classification: score, miss, rebound, turnover, foul, block, steal, sub, timeout.

ParamTypeRequired
limitintegeroptional — default 50

GET /nba/game/:id/lineup

GET/nba/game/:id/lineup

Current 5-man lineup via substitution walk through the play-by-play. ~95% accurate during live games. Returns both teams' current on-court players with headshots and jerseys.

GET /nba/game/:id/shotchart

GET/nba/game/:id/shotchart

Shot chart with x/y coordinates. Made/missed indicator, player, team, period and clock. Coordinate range: x 0–50, y 0–47.

GET /nba/game/:id/winprob

GET/nba/game/:id/winprob

Live win probability curve by play. homeWinPct at each play event.

GET /nba/leaders

GET/nba/leaders

League leaders by stat category. Top 25 returned.

ParamTypeRequiredValues
statstringoptionalPTS, REB, AST, STL, BLK, FG_PCT, FT_PCT, FG3_PCT. Default: PTS
seasonstringoptionalFormat: 2025-26. Default: current.

GET /nba/odds

GET/nba/odds

Game-level NBA odds. Spread, over/under, moneyline.

GET /nhl/schedule/today

GET/nhl/schedule/today

Today's NHL games with available TV broadcast information, venue, scores and game state.

GET /nhl/games/live

GET/nhl/games/live

All NHL games with gameState of LIVE or CRIT (overtime/close game).

GET /nhl/standings

GET/nhl/standings

Full conference and division standings.

ParamTypeRequired
datestringoptional — YYYY-MM-DD

GET /nhl/leaders

GET/nhl/leaders

Skater leaders by category. Top 25 returned.

ParamTypeRequiredValues
categorystringoptionalgoals (default), assists, points
seasonstringoptionalFormat: 20252026. Default: current.

GET /nhl/player/:id/stats

GET/nhl/player/:id/stats

Season stats for any NHL player by NHL Stats API player ID. Returns goals, assists, points, plusMinus, pim, shots, shootingPctg, and more.

GET /nhl/odds

GET/nhl/odds

Available NHL puck line, total and moneyline by game.

Ready to build?

Plans from $29/mo; all 8 core sports from $149/mo. Key in your inbox after checkout. Cancel anytime.

Get API Key — From $29/mo → Full API reference →

Questions? support@proptechusa.ai · 1-888-784-3881