PlayCaller API

120 live endpoints across 9 sports: NFL, MLB, NBA, NHL, CFB, Soccer (6 leagues), Tennis, Golf, and UFC. Player data, stats, scores, standings, injury signals, fantasy scoring, historical trends, and the validated /v1/feed intelligence layer, all in clean JSON.

5-Step Quickstart

From zero to your first successful API call in under 5 minutes.

curl -H "X-PlayCaller-Key: $PC_API_KEY" \
  https://api.playcallerapp.com/intelligence/news?limit=1

SDK Quickstart

Official SDKs for TypeScript and Python, with full IDE autocomplete, typed responses, and built-in retry handling. Auto-generated from the OpenAPI spec so they're always in sync.

npm install @playcaller/sdk

// Full IDE autocomplete + typed responses
import { PlaycallerApiClient } from "@playcaller/sdk";

const client = new PlaycallerApiClient({ apiKey: "pc_sbx_..." });

// Get NFL injury signals
const injuries = await client.intelligence.getIntelligenceInjuries({ sport: "nfl" });

// Get player alpha metrics (Pro Insights+)
const alpha = await client.multi.getPlayerAlphaMetrics({ sport: "nfl", id: "pc_nfl_001234" });

pip install playcaller-sdk

from playcaller import PlaycallerApi

client = PlaycallerApi(api_key="pc_sbx_...")

# Get live MLB game scores
games = client.mlb.list_mlb_games(date="today")

# Semantic player similarity (Pro Insights+)
similar = client.multi.get_similar_players("pc_nfl_001234", sport="nfl")

The PlayCaller MCP server lets Cursor, Claude Desktop, and other AI tools call sports data endpoints directly as tools, no SDK required.

// Add to your Claude Desktop / Cursor MCP config:
{
  "playcaller": {
    "url": "https://api.playcallerapp.com/mcp",
    "headers": { "X-PlayCaller-Key": "pc_sbx_..." }
  }
}

Authentication

All API requests must include your API key in the X-PlayCaller-Key header. Query-string authentication is not supported.

X-PlayCaller-Key: pc_sbx_your_api_key_here

Key prefixes by tier: pc_sbx_ (Sandbox), pc_bld_ (Build), pc_pri_ (Pro Insights), pc_syn_ (Syndicate Alpha).

A valid key returns HTTP 200 with your requested data:

{
  "status": "success",
  "data": { /* ... response payload ... */ }
}

A missing or invalid key returns HTTP 401:

{
  "status": "error",
  "code": "INVALID_API_KEY",
  "message": "API key is missing or invalid. Include it in the X-PlayCaller-Key header."
}

GET /intelligence/news

Real-time player signals across NFL, MLB, NBA, and NHL: injuries, depth chart changes, role shifts, and practice reports. Sourced from beat reporter feeds. Updated every 2 hours. Available on all tiers.
Note: this endpoint is at /intelligence/news, not /v1/intelligence/news, intentionally outside the versioned namespace.

curl -X GET \
  -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/intelligence/news?sport=nfl&severity=high&team=SF&limit=5"

import requests

api_key = "pc_sbx_your_key"
url = "https://api.playcallerapp.com/intelligence/news"

params = {
    "sport": "nfl",
    "severity": "high",
    "limit": 5
}
headers = {"X-PlayCaller-Key": api_key}

response = requests.get(url, headers=headers, params=params)
data = response.json()

for signal in data["data"]:
    print(signal["player_name"], signal["sport"], signal["severity"], signal["summary"])

{
  "success": true,
  "endpoint": "/intelligence/news",
  "count": 2,
  "data": [
    {
      "id": 1247,
      "player_name": "Christian McCaffrey",
      "team": "SF",
      "sport": "nfl",
      "signal_type": "injury_update",
      "severity": "high",
      "title": "McCaffrey listed doubtful with calf injury",
      "summary": "CMC did not practice Wednesday or Thursday. Elijah Mitchell expected to start.",
      "source": "ESPN Injury Report",
      "source_url": "https://espn.com/...",
      "published_at": "2026-03-28T14:32:00Z"
    }
  ],
  "meta": {
    "tier": "sandbox",
    "calls_remaining_today": 195
  }
}

GET /intelligence/injuries

Dedicated injury feed: returns only injury-type signals (injury_update, return_from_injury, injury_return, injury_risk). Filters out general news and role change signals. Updated every 2 hours. Available on all tiers.
Note: this endpoint is at /intelligence/injuries, not /v1/intelligence/injuries.

curl "https://api.playcallerapp.com/intelligence/injuries?sport=nfl&severity=high&team=CIN&limit=5" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

GET /v1/analytics/trends Pro Insights

Historical NFL performance data (2021–2025). Game-by-game stats including fantasy points, snap%, target share, and air yards. Grouped and sorted by player. Requires Pro Insights tier.

curl -X GET \
  -H "X-PlayCaller-Key: pc_pri_your_key" \
  "https://api.playcallerapp.com/v1/analytics/trends?position=RB&season=2024&limit=10"

import requests

api_key = "pc_pri_your_key"
url = "https://api.playcallerapp.com/v1/analytics/trends"

params = {
    "player_name": "McCaffrey",
    "season": 2024
}
headers = {"X-PlayCaller-Key": api_key}

response = requests.get(url, headers=headers, params=params)
data = response.json()

for trend in data["trends"]:
    print(trend["player_name"], "avg fp:", trend["avg_fantasy_points"])

{
  "success": true,
  "endpoint": "/v1/analytics/trends",
  "seasons": [2024],
  "total_records": 12,
  "trends": [
    {
      "player_name": "Christian McCaffrey",
      "team": "SF",
      "position": "RB",
      "games_in_sample": 4,
      "avg_fantasy_points": 28.4,
      "recent_game": {
        "season": 2024,
        "week": 4,
        "opponent": "NE",
        "fantasy_points": 31.2,
        "rushing_yards": 141,
        "rushing_tds": 1,
        "receiving_yards": 71,
        "receptions": 7,
        "snap_pct": 84,
        "target_share": 22,
        "air_yards": 45
      },
      "all_games": [/* ... array of same shape as recent_game ... */]
    }
  ],
  "meta": {
    "tier": "pro",
    "calls_remaining_this_month": 9847
  }
}

MLB: Players

Access the full MLB player database: 966 players across all 30 teams, sourced from MLB Stats API and updated daily. Available on all tiers.

List active MLB players. Filterable by position, team, status, or name search.

curl -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/v1/mlb/players?team=NYY&position=SP&limit=5"

{
  "success": true,
  "total": 18,
  "count": 5,
  "data": [
    {
      "id": "pc_mlb_694973",
      "full_name": "Gerrit Cole",
      "position": "SP",
      "team": "NYY",
      "status": "active"
    }
  ],
  "meta": {
    "sport": "mlb",
    "tier": "sandbox",
    "calls_remaining_this_month": 996
  }
}

Individual player detail by PlayCaller ID (format: pc_mlb_XXXXXX).

curl -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/v1/mlb/players/pc_mlb_660670"

Game-by-game stat lines for a player. Includes batting and pitching stats plus fantasy points. Updated daily after games finalize.

curl -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/v1/mlb/players/pc_mlb_660670/stats?limit=5"

{
  "success": true,
  "player": { "full_name": "Juan Soto", "team": "NYY", "position": "OF" },
  "data": [
    {
      "stat_date": "2026-03-20",
      "batting": { "h": 2, "hr": 1, "rbi": 3, "sb": 0, "r": 2, "bb": 1, "ab": 4 },
      "pitching": { "ip": 0, "k": 0, "sv": 0 },
      "fantasy_points": 16.5,
      "is_final": true
    }
  ]
}

MLB: Teams & Rosters

All 30 MLB teams with roster metadata. Available on all tiers.

Returns all 30 MLB teams with abbreviation, full name, roster size, and position breakdown.

curl -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/v1/mlb/teams"

{
  "success": true,
  "count": 30,
  "data": [
    {
      "abbreviation": "NYY",
      "full_name": "New York Yankees",
      "roster_size": 32,
      "active_players": 29,
      "positions": ["1B","2B","3B","C","OF","RP","SP","SS"]
    }
  ]
}

Full roster for a specific team. Use 3-letter abbreviation (e.g., NYY, LAD, BOS). Optionally filter by ?position=SP.

curl -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/v1/mlb/teams/LAD/roster?position=SP"

MLB: Games

Live and scheduled MLB game states polled from MLB Stats API every few minutes during game windows. Includes live scores, inning state, and lineup status. Available on all tiers.

curl -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/v1/mlb/games?date=2026-03-21"

{
  "success": true,
  "data": [
    {
      "game_pk": 748234,
      "game_date": "2026-03-21",
      "state": "final",
      "home_team": { "name": "Seattle Mariners", "score": 6 },
      "away_team": { "name": "Chicago Cubs", "score": 3 },
      "inning": 9,
      "is_final": true,
      "last_polled": "2026-03-21T04:54:52Z"
    }
  ]
}

MLB: Scoring Pro Insights

Fantasy scoring leaders and rotisserie category leaders powered by PlayCaller's baseball scoring engine. Requires Pro Insights tier.

Top fantasy scorers for a given date (default: latest available date). Filterable by position, team, or date.

curl -H "X-PlayCaller-Key: pc_pri_your_key" \
  "https://api.playcallerapp.com/v1/mlb/scoring/leaders?date=2026-03-20&limit=10"

{
  "success": true,
  "data": [
    {
      "rank": 1,
      "player_name": "Cole Young",
      "team": "Seattle Mariners",
      "position": "SS",
      "fantasy_points": 16.5,
      "batting": { "h": 3, "hr": 1, "rbi": 2, "sb": 1 },
      "is_final": true
    }
  ]
}

Rotisserie category leaders: top performers in HR, RBI, SB, Runs, Walks, IP, Strikeouts, and Saves. Returns top 10 per category for the latest (or specified) game date.

curl -H "X-PlayCaller-Key: pc_pri_your_key" \
  "https://api.playcallerapp.com/v1/mlb/scoring/categories?date=2026-03-20"

{
  "success": true,
  "stat_date": "2026-03-20",
  "home_runs": [
    { "rank": 1, "id": "pc_mlb_660670", "player_name": "Juan Soto", "team": "NYY", "position": "OF", "value": 2, "stat_date": "2026-03-20" }
  ],
  "rbi": [ /* top 10 by RBI */ ],
  "stolen_bases": [ /* top 10 by SB */ ],
  "runs": [ /* top 10 by R */ ],
  "walks": [ /* top 10 by BB */ ],
  "innings_pitched": [ /* top 10 by IP */ ],
  "strikeouts": [ /* top 10 by K */ ],
  "saves": [ /* top 10 by SV */ ]
}

Each category contains an array of up to 10 players. Each entry has: rank, id, player_name, team, position, value (the category stat), and stat_date.

MLB: Standings

Current MLB standings by division. Returns wins, losses, win percentage, and games back for all 30 teams. Available on all tiers.

curl https://api.playcallerapp.com/v1/mlb/standings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

NBA Endpoints

7 NBA endpoints covering game scores, standings, teams, rosters, players, and per-game box score history. Powered by ESPN data pipelines. 127,909 historical game rows across 5 seasons (2021–2025). Available on all tiers.

Returns NBA players. Filterable by name search, position, team, with pagination support.

curl "https://api.playcallerapp.com/v1/nba/players?team=BOS&position=PG" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns full profile for a single NBA player by playcaller_id. Includes position, team, and status from the player identity registry.

curl https://api.playcallerapp.com/v1/nba/players/pc_nba_lebron_01 \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns per-game box score history for an NBA player. Covers 5 seasons (2021–2025) with 127,909 rows total. Supports season and limit filters.

curl "https://api.playcallerapp.com/v1/nba/players/pc_nba_lebron_01/stats?season=2024&limit=10" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns all NBA teams. Filter by conference. Each team includes player_count and a roster_url link.

curl https://api.playcallerapp.com/v1/nba/teams?conference=east \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns active roster for an NBA team by abbreviation (e.g., BOS, LAL, GSW).

curl https://api.playcallerapp.com/v1/nba/teams/BOS/roster \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns NBA game scores and states. Filter by date. Cache-Control: 30s during live games, 120s otherwise.

curl https://api.playcallerapp.com/v1/nba/games?date=today \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns current NBA standings by conference and division.

curl https://api.playcallerapp.com/v1/nba/standings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

NFL Endpoints

6 NFL endpoints covering players, teams, game schedules, and per-game statistical history. Game log data covers the 2024 season (weeks 1–18). Available on all tiers.

Returns NFL players from the player identity registry. Supports search, position, and team filters with pagination.

curl "https://api.playcallerapp.com/v1/nfl/players?team=KC&position=QB" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns full profile for a single NFL player by playcaller_id. Enriched with team name, conference, and division from the 32-team static roster.

curl https://api.playcallerapp.com/v1/nfl/players/pc_nfl_mahomes_01 \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

{
  "success": true,
  "player": {
    "playcaller_id": "pc_nfl_mahomes_01",
    "full_name": "Patrick Mahomes",
    "position": "QB",
    "team": "KC",
    "team_name": "Kansas City Chiefs",
    "conference": "AFC",
    "division": "AFC West",
    "status": "active"
  }
}

Returns per-game statistical history for an NFL player. Data sourced from historical_performance; 2024 season weeks 1–18 are available.

curl "https://api.playcallerapp.com/v1/nfl/players/pc_nfl_mahomes_01/stats?season=2024" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns all 32 NFL teams with conference, division, and active player count. Filter by conference or division.

curl "https://api.playcallerapp.com/v1/nfl/teams?conference=AFC" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns active roster for a team by 2-3 letter abbreviation (e.g., KC, SF, DAL). Optional ?position= filter.

curl "https://api.playcallerapp.com/v1/nfl/teams/KC/roster?position=WR" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns NFL game schedule and scores from the nfl_games table (285 games, 2026 season schedule).

curl "https://api.playcallerapp.com/v1/nfl/games?season=2026&week=1" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns W/L/T records for all 32 NFL teams, computed from game results. Grouped by conference and division. Optional ?season= filter (defaults to current year).

curl "https://api.playcallerapp.com/v1/nfl/standings?season=2026" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

GET /v1/players/search

Search across NFL, MLB, NBA, and NHL player identities in a single call. Useful when the sport is unknown or you want autocomplete across all sports. Returns up to 100 results ordered alphabetically.

curl "https://api.playcallerapp.com/v1/players/search?q=mahomes" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

{
  "success": true,
  "endpoint": "/v1/players/search",
  "count": 1,
  "query": "mahomes",
  "data": [
    {
      "playcaller_id": "pc_nfl_mahomes_01",
      "full_name": "Patrick Mahomes",
      "position": "QB",
      "team": "KC",
      "sport": "nfl",
      "status": "active"
    }
  ]
}

College Football Endpoints

College football game scores, standings, and rankings. Rankings require Growth tier or higher.

Returns CFB game scores and states. Filter by date.

curl https://api.playcallerapp.com/v1/cfb/games?date=2026-04-10 \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns current CFB conference standings.

curl https://api.playcallerapp.com/v1/cfb/standings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns AP Top 25 and CFP rankings. Requires Growth tier or higher.

curl https://api.playcallerapp.com/v1/cfb/rankings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

NHL Endpoints

NHL game scores, live updates, and division standings. Available on all tiers.

Returns NHL game scores and states. Optional ?date=today, ?state=in_progress, ?limit=.

curl https://api.playcallerapp.com/v1/nhl/games?date=today \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns NHL standings grouped by division. Optional ?season= and ?division=.

curl https://api.playcallerapp.com/v1/nhl/standings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Soccer Endpoints

Soccer game scores and league standings across 6 major leagues: EPL, MLS, La Liga, Bundesliga, Serie A, and UEFA Champions League. Available on all tiers.

Returns match scores and states. Filter by ?league=epl|mls|la_liga|bundesliga|serie_a|champions_league, ?date=today.

curl https://api.playcallerapp.com/v1/soccer/games?league=la_liga&date=today \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns current league table. Filter by ?league=epl|mls|la_liga|bundesliga|serie_a|champions_league.

curl https://api.playcallerapp.com/v1/soccer/standings?league=bundesliga \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Tennis Endpoints

ATP and WTA match scores and results. Year-round coverage across all Grand Slams and tour events. Available on all tiers.

Returns live and completed matches. Filter by ?tour=atp|wta, ?date=today, ?state=in_progress|final.

curl https://api.playcallerapp.com/v1/tennis/matches?tour=atp&date=today \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Golf Endpoints

PGA Tour and LPGA Tour leaderboards with live scoring updated every 4 hours during active tournaments. Available on all tiers.

Lists active and recent tournaments. Optional ?tour=pga|lpga.

curl https://api.playcallerapp.com/v1/golf/tournaments \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns current tournament leaderboard with positions, scores to par, and round-by-round scores. Optional ?tour=pga|lpga, ?limit= (max 156).

curl https://api.playcallerapp.com/v1/golf/leaderboard?limit=25 \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

NASCAR Endpoints

NASCAR Cup Series race results and computed driver standings (2026 points table). Available on all tiers.

Returns races PlayCaller has synced results for, most recent first. Unlike F1, each NASCAR event is a single race (no separate practice/qualifying sessions in the source data).

curl https://api.playcallerapp.com/v1/nascar/races \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns per-driver finishing position for one race. Defaults to the most recent race if `?event=` is omitted. Sourced from ESPN's public racing API — no lap times, gaps, or team/manufacturer data are available (confirmed unavailable at the source), only finishing order.

curl https://api.playcallerapp.com/v1/nascar/results \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Driver standings computed from stored race results using the 2026 NASCAR Cup Series finishing-position points table (55 for the win, 35-1 decreasing for 2nd-40th). Excludes stage points, the fastest-lap bonus, and best-effort-excludes non-points exhibition races (Clash, Duels, All-Star) — none of that is available from the source. Not pulled from a live ESPN standings feed — that endpoint returns no structured data.

curl https://api.playcallerapp.com/v1/nascar/standings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

F1 Endpoints

Race weekend results (per-session finishing position) and computed driver standings. Available on all tiers.

Returns race weekends PlayCaller has synced results for, most recent first. Each event contains multiple sessions (FP1/FP2/FP3/Qual/Race) — use `/v1/f1/results?event=` to fetch session detail.

curl https://api.playcallerapp.com/v1/f1/races \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns per-driver finishing position for one race weekend, across all sessions (FP1/FP2/FP3/Qual/Race) or filtered to one via `?session=`. Defaults to the most recent race weekend if `?event=` is omitted. Sourced from ESPN's public racing API — no lap times, gaps, or team/constructor data are available (confirmed unavailable at the source), only finishing order per session.

curl https://api.playcallerapp.com/v1/f1/results \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Driver standings computed from stored Race-session results using F1's official points table (25-18-15-12-10-8-6-4-2-1 for the top 10). Not pulled from a live ESPN standings feed — that endpoint returns no structured data.

curl https://api.playcallerapp.com/v1/f1/standings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

UFC Endpoints

Fighter and event data for upcoming and recent UFC cards. Available on all tiers unless noted.

Returns upcoming and recent UFC fight cards. Each row is one bout — group by `card_name` / `card_date` on the client side to reconstruct the full card.

curl https://api.playcallerapp.com/v1/ufc/events \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns all fighters appearing on upcoming or recent UFC cards, with their next scheduled fight date and card name.

curl https://api.playcallerapp.com/v1/ufc/fighters \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Win/loss/method record for a specific fighter, aggregated from stored ESPN fight results. Fighter name is a case-insensitive partial match.

curl https://api.playcallerapp.com/v1/ufc/fighters/{name}/record \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

ESPN's own consensus rankings across all 12 weight classes plus men's/women's pound-for-pound, refreshed every 12h. Omit `division` to list available divisions; pass a partial name match (e.g. `Lightweight`) to get ranked fighters.

curl https://api.playcallerapp.com/v1/ufc/rankings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

GET /v1/sports

Returns the list of all sports and endpoints currently available in the API. Useful for dynamically discovering available data sources and their status.

curl https://api.playcallerapp.com/v1/sports \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

GET /daas/usage

Returns quota usage, rate limit, and tier information for the authenticated API key. Use this to build quota-aware dashboards or to monitor remaining calls before you hit limits. Available on all tiers.

curl -X GET \
  -H "X-PlayCaller-Key: pc_sbx_your_key" \
  "https://api.playcallerapp.com/daas/usage"

{
  "success": true,
  "key_prefix": "pc_sbx_abc1...",
  "tier": "sandbox",
  "is_trial": true,
  "trial_starts_at": "2026-03-28T00:00:00Z",
  "trial_ends_at": "2026-04-11T00:00:00Z",
  "trial_days_remaining": 12,
  "calls_this_month": 153,
  "calls_limit_month": 1000,
  "calls_remaining": 847,
  "rate_limit_per_min": 30,
  "reset_at": "2026-04-01T00:00:00Z",
  "upgrade_url": "https://playcallerapp.com/developer#pricing",
  "endpoint_breakdown": [
    {
      "endpoint": "/v1/intelligence/news",
      "calls": "98",
      "avg_ms": 42,
      "last_call": "2026-03-28T11:52:33Z"
    },
    {
      "endpoint": "/v1/mlb/players",
      "calls": "55",
      "avg_ms": 61,
      "last_call": "2026-03-28T10:14:07Z"
    }
  ]
}

Growth+ Endpoints

Advanced intelligence endpoints — odds, projections, roster context, batch lookups, and platform utilities. Growth tier and above unless noted.

Training camp and in-season depth chart moves detected from Sleeper daily snapshots. Includes AI-generated blurbs explaining fantasy impact. Active Jul 20–Feb; returns empty array off-season.

curl https://api.playcallerapp.com/v1/nfl/depth-chart/changes \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Players ranked by consensus Average Draft Position (ADP), blended from Sleeper and FantasyCalc. Includes position rank, tier, and our validated confidence score where available. Refreshed weekly.

curl https://api.playcallerapp.com/v1/nfl/players/rankings \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Aggregated training camp snapshot: current depth chart position changes (last 30 days), practice status, anomaly signals, and recent game stats. Replaces 5 separate endpoint calls with a single request.

curl https://api.playcallerapp.com/v1/nfl/players/pc_nfl_4046533/camp-intel \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Rank NFL players by expected fantasy points in your league's exact scoring system. Pass scoring weights in the request body; receive players sorted by `custom_pts_per_game` — computed from prior-season per-game averages.

curl -X POST https://api.playcallerapp.com/v1/nfl/rankings/custom \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns a ranked list of waiver-eligible players ordered by anomaly signal strength. Combines usage spikes, snap-share shifts, and target-rate anomalies into a single priority score — no client-side merging required. Optionally excludes injured players.

curl https://api.playcallerapp.com/v1/nfl/waiver-priority \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Single-call team lineup intelligence: returns the current roster, recent injury updates, depth chart changes (NFL only), and active anomaly signals for any player on the team. Aggregates 4 data sources in one request. Counts as 4 requests toward your rate limit (`X-PC-Request-Weight: 4` response header).

curl https://api.playcallerapp.com/v1/nfl/teams/KC/roster-pulse \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Current spread, total, and moneyline odds for upcoming games, plus PlayCaller-computed implied point totals derived from moneylines. Sourced from TheOddsAPI (DraftKings + FanDuel), refreshed every 4 hours.

curl https://api.playcallerapp.com/v1/nfl/odds \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns all captured odds snapshots for a specific game, ordered chronologically. Useful for detecting line movement, sharp action, and steam moves. History depth depends on how early the game was tracked.

curl https://api.playcallerapp.com/v1/nfl/odds/history/game_2026_wk5_kc_buf \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns a team's game schedule — past results and upcoming games. NFL uses `nfl_games`; NBA, NHL, CFB, and Soccer use the ESPN live game feed. Filter by status to get only upcoming or only completed games.

curl https://api.playcallerapp.com/v1/nfl/teams/KC/schedule \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns all active beat reporter injury signals for a given team — every player with a reported injury, sorted by severity. Useful for opponent analysis, weekly lineup decisions, and DFS game-day research.

curl https://api.playcallerapp.com/v1/nfl/teams/KC/injuries \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns active beat reporter signals and injury reports for a specific player. Works across NFL, MLB, NBA, NHL, and all covered sports. Signals are refreshed every 2 hours.

curl https://api.playcallerapp.com/v1/nfl/players/pc_nfl_4046533/news \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns a side-by-side comparison of two players — identity, active injury signals, anomaly/heat score, and last 5 games of stats. Use for start/sit decisions, trade analysis, or DFS lineup construction.

curl https://api.playcallerapp.com/v1/players/compare \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns per-sport data freshness timestamps, player counts, active signal counts, and last anomaly scoring time. Use this to verify data recency before building time-sensitive features or to display "last updated" metadata to your users.

curl https://api.playcallerapp.com/v1/data/status \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Full beat reporter signal feed with sport, severity, and type filters. More flexible than `/intelligence/news` — supports date ranges up to 200 signals, all sports, and granular filtering. Signals are refreshed continuously from ESPN, Reddit, and AI-extracted injury intel.

curl https://api.playcallerapp.com/v1/intelligence/signals \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Fetch profile, stats, and optional injury/anomaly data for up to 50 players in a single API call. Reduces round-trips for clients that need to hydrate a lineup, compare a watchlist, or build a dashboard.

curl -X POST https://api.playcallerapp.com/v1/batch/players \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Fetch ML signals for up to 25 players in a single request. Returns confidence score, confidence tier, alpha metrics, and ADP for each player. Each player in the batch counts as one call against your daily limit.

curl -X POST https://api.playcallerapp.com/v1/batch/signals \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns per-week NFL confidence model predictions for a player, including resolved outcomes (actual fantasy points vs. positional median) and rolling hit rate. Useful for validating our model's accuracy on specific players and building ML training pipelines.

curl https://api.playcallerapp.com/v1/model/predictions/pc_nfl_4046533 \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns a paginated, time-ordered audit trail of key management events (key rotation, IP allowlist changes) and administrative actions associated with your API key. Rolling 90-day retention.

curl https://api.playcallerapp.com/v1/audit/events \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns tier, trial status, and creation date for the API key passed as `?key=` query parameter. Useful for building key verification flows in your own applications without exposing the full usage payload.

curl https://api.playcallerapp.com/daas/key-info \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Provisions a 14-day Sandbox API key and returns it immediately in the response body — no email verification gate, no credit card required. Use this to start calling PlayCaller MCP tools from Claude Desktop, Cursor, Windsurf, or any MCP-compatible AI agent within seconds.

curl -X POST https://api.playcallerapp.com/mcp/start-trial \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns a single player's full validated intelligence dossier: confidence score/tier, heat signal, anomaly flag, and the underlying model attribution -- assembled by the same `assembleDossier()` used by the consumer-facing Feed product. Every field is backed by a measurement (AUC-validated model or a real detected signal), never a hollow heuristic, per Doctrine #1.

curl https://api.playcallerapp.com/v1/feed \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Lists every ACTIVE model in `model_registry` (AUC-ROC, decile lift, training seasons, feature signals) -- the transparency layer behind every confidence score this API returns. Per Doctrine #1, no score ships without a corresponding row here.

curl https://api.playcallerapp.com/v1/model/metadata \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Ranks players by count of active beat reporter signals in the last 7 days — a real-world attention/news-volume signal, not a model score.

curl https://api.playcallerapp.com/v1/players/trending \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Query players by stat thresholds (snap %, target share, fantasy points) against the most recent daily stat row per player. Whitelist-only query params.

curl https://api.playcallerapp.com/v1/players/filter \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Consensus rankings blending consensus ADP (NFL) or the sport's AUC-validated confidence model (NBA/MLB) with a tier grouping and a plain-language consensus label.

curl https://api.playcallerapp.com/v1/nfl/ecr \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Full play-by-play feed for a game, sourced live from ESPN's game summary endpoint (not stored/replayed -- reflects the current ESPN state at request time).

curl https://api.playcallerapp.com/v1/nfl/games/game_2026_wk5_kc_buf/plays \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Streams every player in a sport as newline-delimited JSON (`application/x-ndjson`), one row per line, no pagination needed. Sent as a file download (`Content-Disposition: attachment`).

curl https://api.playcallerapp.com/v1/bulk/export \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Per-player practice participation status (DNP/limited/full) from ESPN's public injury feed, refreshed twice daily.

curl https://api.playcallerapp.com/v1/nfl/teams/KC/practice \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Simple, honest ROS projection: last-8-games fantasy-points average, extrapolated across the requested number of remaining weeks. `basis` is null (and projected fields are null) when there isn't enough recent game data — no fallback guess.

curl https://api.playcallerapp.com/v1/nfl/players/pc_nfl_4046533/projection \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Batter platoon splits (OPS/OBP/SLG/AVG vs. left- and right-handed pitching). Only MLB has data today — other sports return a 400 with the current `splits_available` list.

curl https://api.playcallerapp.com/v1/nfl/players/pc_nfl_4046533/splits \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Coming soon: real DraftKings/FanDuel slate and salary data needs a licensed feed, which is not in place yet, so this endpoint returns no slates today. Lists DraftKings/FanDuel/Yahoo DFS slates for a sport within a recent date window.

curl https://api.playcallerapp.com/v1/nfl/dfs/slates \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Coming soon: real DraftKings/FanDuel slate and salary data needs a licensed feed, which is not in place yet, so this endpoint returns no salaries today. Player salaries, projected points, and ownership % for a specific DFS slate.

curl https://api.playcallerapp.com/v1/nfl/dfs/slates/{slateId}/salaries \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Coming soon: needs the DFS slate and salary data, which is not loaded yet. Generates an optimized DFS lineup for a slate using a greedy knapsack algorithm, boosted by alpha metrics (opportunity_ceiling) as a value-score adjustment.

curl -X POST https://api.playcallerapp.com/v1/lineup/optimize \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Oldest/newest season and row counts per sport in the historical stats tables. Use this to know how far back a given sport's data actually goes before querying it.

curl https://api.playcallerapp.com/v1/meta/coverage \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Returns current per-minute and daily request usage/remaining for the authenticated API key. RapidAPI-proxied keys get a synthetic per-minute-only response (daily quota is managed by the RapidAPI dashboard, not this system).

curl https://api.playcallerapp.com/daas/rate-limit-status \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Re-sends a previously-delivered webhook payload to the registered URL, with a fresh HMAC signature and an `X-PlayCaller-Replay: true` header, and logs the attempt as a new delivery row.

curl -X POST https://api.playcallerapp.com/daas/webhooks/pc_nfl_4046533/deliveries/{deliveryId}/replay \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Rate Limits & Response Headers

Rate limits are enforced per API key, measured daily and per-minute. Daily limits reset at midnight UTC.

Every authenticated response includes standard rate-limit headers so you can track your position without polling /daas/usage:

# Check your rate-limit position from any response headers
curl -sI -H "X-PlayCaller-Key: pc_sbx_your_key" \
  https://api.playcallerapp.com/v1/sports \
  | grep -i x-ratelimit

X-RateLimit-Limit: 200
X-RateLimit-Remaining: 194
X-RateLimit-Reset: 1751846400
X-RateLimit-Policy: 200/day;w=86400, 2/min;w=60

Pro+ is a forthcoming add-on tier: priority access to new validated confidence models as they ship. See the waitlist page for details. Pricing and rate limits aren't finalized yet.

Exceeding your per-minute limit returns HTTP 429. The Retry-After header tells you exactly when to retry:

{
  "error_code": "RATE_LIMIT_EXCEEDED",
  "message": "Rate limit of 30 req/min exceeded. Retry in 42s or upgrade your plan.",
  "calls_this_minute": 31,
  "limit_per_minute": 30,
  "retry_after_seconds": 42,
  "upgrade_url": "https://playcallerapp.com/?upgrade=1"
}

Once your monthly call quota is used up, all requests return HTTP 429 until your billing cycle resets:

{
  "error_code": "MONTHLY_QUOTA_EXCEEDED",
  "message": "Monthly call quota of 1000 exceeded. Resets on 2026-04-01.",
  "calls_used": 1000,
  "calls_limit": 1000,
  "resets_on": "2026-04-01T00:00:00Z",
  "upgrade_url": "https://playcallerapp.com/?upgrade=1"
}

Error Codes

All errors return a standardized JSON object with error_code, message, and documentation_url.

{
  "error_code": "TRIAL_EXPIRED",
  "message": "Your 14-day Developer Sandbox has expired. Upgrade to a paid plan to continue.",
  "trial_ended_at": "2026-04-11T00:00:00Z",
  "upgrade_url": "https://playcallerapp.com/?upgrade=1"
}

{
  "error_code": "TIER_INSUFFICIENT",
  "message": "This endpoint requires pro_insights tier or higher. Your current tier: build.",
  "current_tier": "build",
  "required_tier": "pro_insights",
  "upgrade_url": "https://playcallerapp.com/?upgrade=1"
}

GET /v1/feed Pro Insights

Pre-composed player intelligence dossier. Returns a complete intelligence object for a player in a single API call: calibrated confidence score, validated heat signal, full signal breakdown, and a plain-English synthesis sentence. Rate-capped on Pro Insights; uncapped on Syndicate Alpha. Requires Pro Insights tier.

MCP Server

PlayCaller implements Anthropic's Model Context Protocol over HTTP. Connect Cursor, Claude Desktop, Perplexity, or any MCP-compatible AI to live sports intelligence with a single endpoint.

Add to .cursor/mcp.json or Claude Desktop config:

{ "mcpServers": { "playcaller": { "url": "https://api.playcallerapp.com/mcp", "headers": { "X-PlayCaller-Key": "YOUR_KEY" } } } }

Full tool schemas at GET /mcp (unauthenticated discovery). Auth: X-PlayCaller-Key header on POST.

GET /v1/trending

Returns the top hashtag trends across sports, scraped every 2 hours. Useful for surfacing breakout player moments and news spikes. Available on all tiers. Max 50 results.

curl "https://api.playcallerapp.com/v1/trending?sport=mlb&limit=10" \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

GET /v1/articles/waiver

Returns AI-generated waiver wire analysis articles backed by validated signal data. Requires Pro Insights tier. The sport parameter is required.

curl "https://api.playcallerapp.com/v1/articles/waiver?sport=nfl" \
  -H "X-PlayCaller-Key: pc_pri_your_key"

GET /v1/nba/confidence

Returns detailed NBA player confidence scores from the validated NBA Confidence V3 model (AUC 0.847 on the latest walk-forward fold). Includes raw score, percentile rank, component breakdown, and a model audit block. Requires Pro Insights tier.

curl "https://api.playcallerapp.com/v1/nba/confidence?limit=5" \
  -H "X-PlayCaller-Key: pc_pri_your_key"

GET /v1/meta/coverage

Returns the current historical data depth per sport: oldest/newest season and row counts, computed live from the database. Free on all tiers, including Sandbox. Use this instead of a hardcoded year range in your integration: backfills land per-sport independently, so the actual coverage window changes over time.

curl https://api.playcallerapp.com/v1/meta/coverage \
  -H "X-PlayCaller-Key: pc_sbx_your_key"

Note: this endpoint reports coverage from the historical_performance table only. Endpoints backed by a different table (e.g. MLB's branch of games/history, which uses a separate daily box-score log) aren't reflected here, so check that endpoint's own docs for how to verify its range.

GET /v1/:sport/games/history

Returns historical per-game performance data for players. Supports nfl, nba, and mlb. NFL returns snap_pct, target_share, air_yards. NBA returns usage_rate, is_starter, is_back_to_back. MLB returns full batting and pitching lines. Requires Pro Insights tier.

Data depth: NFL and NBA cover the 2021–2025 seasons (sourced from historical_performance; see live per-sport counts at GET /v1/meta/coverage, free on all tiers). MLB game history is sourced from a separate live daily box-score log rather than historical_performance, so its year range isn't reflected by /v1/meta/coverage. Pass a season value to test availability for a given year.

curl "https://api.playcallerapp.com/v1/nfl/games/history?team=KC&season=2025" \
  -H "X-PlayCaller-Key: pc_pri_your_key"

GET /v1/:sport/players/:id/alpha

Returns pre-computed alpha metrics for a player: consistency score, momentum delta, and opportunity ceiling. Computed weekly from the last 8 games of historical performance data. Requires Pro Insights tier.

curl "https://api.playcallerapp.com/v1/nfl/players/pc_nfl_4046533/alpha" \
  -H "X-PlayCaller-Key: pc_pri_your_key"

GET /v1/players/similar/:id

Returns players with the most similar production profile using pgvector cosine similarity. Each player is represented as an 8-dimensional stat vector (avg fantasy points, usage, opportunity, rushing yards, receiving yards, consistency, momentum, ceiling), no LLM, purely computed from historical performance. Requires Pro Insights tier.

curl "https://api.playcallerapp.com/v1/players/similar/pc_nfl_4046533?sport=nfl&limit=5" \
  -H "X-PlayCaller-Key: pc_pri_your_key"

GET /v1/events/stream

Opens a persistent Server-Sent Events connection that pushes real-time sports events as they happen. Heartbeat every 30 seconds keeps the connection alive. Requires Pro Insights tier.

curl -N "https://api.playcallerapp.com/v1/events/stream" \
  -H "X-PlayCaller-Key: pc_pri_your_key"

const source = new EventSource(
  "https://api.playcallerapp.com/v1/events/stream",
  { headers: { "X-PlayCaller-Key": "pc_pri_your_key" } }
);
source.addEventListener("player.injured", e => console.log(JSON.parse(e.data)));
source.addEventListener("game.score_updated", e => console.log(JSON.parse(e.data)));

Webhooks (Syndicate Alpha)

Register HTTPS endpoints to receive push delivery of sports events as they happen. Every delivery is signed with HMAC-SHA256 so you can verify it came from PlayCaller. Auto-retry on failure (0s → 30s → 5min). Requires Syndicate Alpha tier.

Every POST includes X-PlayCaller-Signature: sha256=<hex> and X-PlayCaller-Delivery-Id headers. Verify before processing:

const crypto = require('crypto');
function verifySignature(secret, rawBody, sigHeader) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sigHeader));
}

curl -X POST "https://api.playcallerapp.com/daas/webhooks" \
  -H "X-PlayCaller-Key: pc_syn_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://your-server.com/hooks","events":["player.injured","game.score_updated"]}'

Pass any subset of these event types in the events[] array when registering:

All events share the same outer envelope. Only data differs by event type:

{
  "event": "player.injured",
  "delivery_id": "del_a1b2c3d4",
  "timestamp": "2026-07-17T14:23:01Z",
  "data": {
    "player_id": "nfl_patrick-mahomes",
    "name": "Patrick Mahomes",
    "sport": "nfl",
    "injury_status": "Questionable",
    "injury_type": "Knee",
    "previous_status": "Probable"
  }
}

Roadmap

New capabilities ship with the Pro+ tier as they clear validation. Join the waitlist to lock in early pricing.