PropSports API documentation

PropSports API is a REST API delivering real-time sports data for MLB, NFL, NBA, WNBA, NHL, tennis and soccer. 151 endpoints. All responses are JSON. All requests use GET. Cloudflare Workers edge network — sub-100ms globally.

What makes PropSports different from every other sports API: we own our Statcast data pipeline and we generate our own Poisson model odds from it. No DraftKings. No FanDuel. No sportsbook dependency. The /mlb/odds/model/* family of endpoints has no equivalent anywhere else at this price point.

Authentication

Pass your API key in the X-API-Key request header or as a ?key= query param.

# Header auth (recommended)
curl https://propsports-api.sales-fd3.workers.dev/mlb/schedule/today \
  -H "X-API-Key: your_api_key_here"

# Query param auth (also works)
curl https://propsports-api.sales-fd3.workers.dev/mlb/schedule/today?key=your_api_key_here

# Use your API key\ncurl https://propsports-api.sales-fd3.workers.dev/mlb/schedule/today?key=your_api_key_here

const BASE = 'https://propsports-api.sales-fd3.workers.dev';
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);

import requests

BASE = "https://propsports-api.sales-fd3.workers.dev"
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

https://propsports-api.sales-fd3.workers.dev

Rate Limits

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

Errors & Status Codes

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

{
  "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"
}

Route catalog

The production catalog has 206 documented routes across MLB, NFL, NBA, WNBA, NHL, Tennis and Soccer. 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.

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

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.

{
  "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

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.

const plays = await fetch(
  'https://propsports-api.sales-fd3.workers.dev/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

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

curl "https://propsports-api.sales-fd3.workers.dev/mlb/odds/model/player?name=Soto" \
  -H "X-API-Key: your_key"

GET /mlb/odds/hr

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

{
  "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

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

GET /mlb/odds/hits

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

GET /mlb/odds/strikeouts

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

GET /mlb/odds/rbi

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

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

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

GET /mlb/odds

Game-level MLB odds from ESPN. Spread, over/under, moneyline for each game today.

GET /mlb/schedule/today

Full MLB slate for today. Hydrated with probable pitchers, venue, teams, and linescore. Source: MLB Stats API.

{
  "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

Schedule for any date.

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

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

GET /mlb/game/:gamePk/linescore

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

GET /mlb/game/:gamePk/boxscore

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

GET /mlb/game/:gamePk/plays

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

GET /mlb/player/:id/stats

Season stats by MLB player ID.

GET /mlb/player/:id/gamelog

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

GET /mlb/statcast/batters

PropTechUSA owned Statcast leaderboard. 150 active batters aggregated nightly from Baseball Savant. The most comprehensive public Statcast endpoint available at any price point.

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.

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.

{
  "indoor": false,
  "park": "Fenway Park",
  "parkFactor": 104,
  "windSpeed": 12.4,
  "windDir": 220,
  "windLabel": "SW",
  "temp": 71
}

GET /mlb/weather/all

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

GET /mlb/umpires

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

GET /nfl/schedule

NFL schedule. Defaults to current week. Returns spread, over/under, venue, and score for each game. Source: ESPN.

GET /nfl/games/live

All NFL games currently in progress.

GET /nfl/odds

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

GET /nfl/scoreboard

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

GET /nfl/standings

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

GET /nfl/teams

NFL team directory with stable ESPN IDs, abbreviations, names, logos, colors, active status, and links.

GET /nfl/team/:id

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

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

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

GET /nfl/game/:id

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

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

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

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

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

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

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

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

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.

{
  "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

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

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

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

GET /nba/game/:id/winprob

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

GET /nba/leaders

League leaders by stat category. Top 25 returned.

GET /nba/odds

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

GET /nhl/schedule/today

Today's NHL games with TV broadcast info, venue, scores, and game state. Source: NHL Stats API.

GET /nhl/games/live

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

GET /nhl/standings

Full conference and division standings. Source: NHL Stats API.

GET /nhl/leaders

Skater leaders by category. Top 25 returned.

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

Game-level NHL odds. Puck line, over/under, moneyline from ESPN.