API Documentation

Today's MLB schedule with betting odds and heavy matchup context — rest days, injuries, probable-pitcher ERA/WHIP/FIP, team OPS/wOBA, bullpen quality, and recent run differential.

Query Parameters

Single game detail — full box score, odds from every vendor, pre-game lineup, and the last 50 plays.

Spreads, moneylines, and totals for one or more games.

Query Parameters

Game-level matchup analysis — run-environment/stack recommendation and pitcher-vs-lineup breakdown for both sides.

Query Parameters

A single player's batting or pitching box score line for a specific game.

Batting lineup and probable pitchers for both teams, with standings, injuries, and predicted lineups for games without a confirmed one yet.

Full play-by-play, grouped by inning (top/bottom), including pitch type, velocity, and trajectory where available.

AI-generated prose recap of a completed game, cached permanently once generated. Returns 400 if the game isn't final yet, 202 if a recap is already being generated.

AI-generated pregame preview with narrative, outlook, and quick facts. Generated as soon as both teams' official starting lineups post, or an hour before first pitch at the latest; falls back to an algorithmic narrative until then.

Weather and wind intelligence for the ballpark at first pitch — wind speed/direction, temperature, home-run boost rating, and run-environment impact.

Current line from every vendor plus a historical line-movement timeline for one vendor.

Query Parameters

Win-count record between the two teams over their last 10 meetings.

Team/game-level betting markets — run line, first-5-innings, correct score, team totals, and more (excludes player props; see the player-level odds-markets endpoint under Players).

Query Parameters

Today's slate overview — spread/total/win probability per game, run-environment classification, key injuries, probable pitchers, and per-game player tags (core/value/fade batters).

Query Parameters

Historical hit/miss results for the Key Suspects engine on a completed slate date (backtesting view).

Query Parameters

Batters and pitchers whose recent average for a stat meets or exceeds today's live prop line.

Query Parameters

Today's projected batting-stat leaders with a sparkline, trend %, opposing-pitcher matchup rating, pitcher fatigue, and a signal badge (elite_spot, rising, risky, and more).

Query Parameters

Today's projected strikeout leaders among probable starters, with recent form, opponent-lineup matchup context, and signal badges.

Query Parameters

Today's games ranked by DFS/props stack attractiveness — run environment, favored stack side, pitcher-vs-lineup matchup, and top recommended batters to stack.

Auto-built parlay "cases" assembled from the Key Suspects engine across the slate, scored by suspicion score, hit rate, and odds value.

Query Parameters

EV Finder — every vendor's game odds, plus player props with at least a +3% edge against the offered odds based on recent hit rate.

DFS slate data — slates, games in the slate, roster-slot definitions, and draftable players with salary, position, and eligibility.

Query Parameters

Ranked list of a game's most notable player-prop/DFS suspects. Free/Pro/Elite see 1/3/7 of the same curated list.

Query Parameters

Batch-computes a cached matchup verdict (favorable/unfavorable) for up to 30 players at once.

Body Parameters

Aggregate upvote/downvote counts per suspect for a game, plus the caller's own current vote.

Casts or toggles a vote on a suspect. Voting the same direction twice cancels it back to neutral. Returns the suspect's updated aggregate counts.

Body Parameters

Player search by name — returns id, full name, position, and team for matches.

Query Parameters

Player profile — name, position, jersey, bats/throws, physicals, birthplace, debut year, draft info, and current team.

Season totals and rate stats (batting and/or pitching) for one player-season.

Query Parameters

Split-stat breakdown by arena, pitcher hand, day/night, month, opponent, situation, batting order, count, and position.

Query Parameters

AVG/OBP/SLG/OPS split vs. left- and right-handed opponents (pitchers for a batter, batters for a pitcher), with a league percentile rank.

Per-game batting and pitching stat lines for the current season, most recent first.

Query Parameters

Player prop lines across all prop types and vendors for a specific game.

Query Parameters

This player's betting markets and outcomes for one game, across all vendors.

Query Parameters

Historical hit-rate tracker — how often the player's actual result beat the line, all-time and over the last 10 games.

Query Parameters

Intraday line movement per prop type and vendor. Elite/Admin accounts also see cross-book consensus-shift detection.

Query Parameters

A pitcher's per-pitch-type arsenal — usage%, zone%, chase%, whiff%, contact%, and results allowed by pitch type.

Query Parameters

Statcast-derived pitch movement — average velocity, spin rate, induced vertical break, horizontal break, and release extension per pitch type.

Query Parameters

A hitter's performance against each pitch type — whiff/chase/contact/zone %, BA/SLG/wOBA, and outcome counts.

Query Parameters

Current injury status, return date, and description for a player.

Pre-game matchup packet — the batter's season stats and splits against the opposing probable pitcher's profile, plus career stats vs. that opponent.

Query Parameters

Ranked season leaderboard for one batting or pitching stat category, with a 5-game sparkline.

Query Parameters

All MLB teams — ID, abbreviation, names, league, and division.

Full season schedule for a team with scores, status, and opponent info.

Query Parameters

Current active roster with each player's current-season batting/pitching stat line attached.

Query Parameters

A team's standings row (wins, losses, streak) for a season.

Query Parameters

Team's current injury report — player, status, return date, and description.

Team batting, pitching, and fielding season totals (regular season only).

Query Parameters

Team-level batting AVG/OPS vs. left- and right-handed pitching for the current season, with league rank.

All-time SportsFBI prediction-accuracy stats — predictions made/graded/hit, hit rate, key suspects surfaced, and props currently tracked.

Same grading methodology scoped to the single most recent fully-graded slate date.

Full result ledger for one date's slate — every game's prediction vs. actual outcome graded hit/miss/pending, plus navigable previous/next dates.

Query Parameters

List of the last 90 days' fully-completed slate-recap dates.

Games on a given local calendar day, with odds, a derived win/loss record, and the SportsFBI edge projection per game. NFL's slate clusters on Thu/Sun/Mon, so fallback=last walks forward to the next date with real games instead of backward.

Query Parameters

Single game detail — quarter-by-quarter score, all-vendor odds comparison, frozen opening moneyline, full box score, derived team records, and the SportsFBI edge engine output.

Query Parameters

Spreads, moneylines, and totals for one or more games.

Query Parameters

AI-generated pregame preview, gated to within an hour of kickoff.

AI-generated prose recap of a completed game, cached permanently once generated. Returns 400 if the game isn't final yet, 202 if a recap is already being generated.

Consensus: authenticated callers can use marketScope=consensus for cross-book history and current consensus; otherwise the selected vendor is used.

Authoritative opening line, intraday movement snapshots, and the latest quote per vendor.

Query Parameters

Full play-by-play grouped by quarter/OT, with team stats, top player-stat leaders, and a computed live-game-center overlay (win-probability deltas, event markers).

Consensus: marketScope=consensus requests the canonical cross-book pool. availableAt optionally limits it to picks offered by a supported sportsbook. If consensus is unavailable, the vendor pool is returned with consensusFallback=true and fallbackVendor. Consensus access and the number/bands of visible suspects depend on authentication and plan.

Ranked list of a game's most notable player-prop suspects with suspicion scores and evidence factors.

Query Parameters

Access: authenticated with the premiumData entitlement. marketScope=consensus grades frozen consensus snapshots, falling back per game to the selected vendor. Responses identify fallback games. Live fallback candidates remain ungraded; they are not historical recommendations.

Historical hit/miss results for the Key Suspects engine on a completed slate date (backtesting view).

Query Parameters

EV Finder — every vendor's game odds, plus player props (Pro/Elite/Admin in the app; Elite API key required for direct access) with an edge against the offered odds based on a no-vig consensus across other books.

Query Parameters

Access: authenticated; case count and leg limits depend on plan. Uses consensus by default, with vendor fallback per game when no consensus suspects exist. Each consensus leg uses the best available sportsbook quote at its canonical line, rather than fair consensus odds. Responses include consensus and fallback metadata. refresh=true bypasses the cache. Free accounts allow 2-4 legs and use a -200 odds floor; paid accounts allow 2-10 legs and default to -150.

Auto-built parlay "case" cards assembled from that day's scheduled games' Key Suspects picks, with combined American odds.

Query Parameters

Player search by name — returns id, full name, position, and team for matches.

Query Parameters

Player profile — identity, position, physicals, team, plus most recent injury status.

Distinct list of seasons for which this player has any game or season stats.

Season totals for one player-season.

Query Parameters

Per-game box-score log, newest first, joined to opponent/date/result context.

Query Parameters

Player prop lines (line, over/under/milestone odds, market type) for a specific game.

Query Parameters

Historical hit-rate tracker — how often the player's actual result beat the line.

Query Parameters

Per-prop-type/vendor line-movement timeline for a player in one game, opening line through subsequent moves.

Query Parameters

All NFL teams — ID, abbreviation, name, conference, and division.

Full roster with depth-chart position, injury status, and nested per-player season stats where available.

Query Parameters

Team's current injury report — player, status, comment, and injury date.

Derived win/loss/tie record, points for/against, point differential, and win streak, computed from completed games.

Query Parameters

Every game the team plays that season across all season types (preseason included), with score/status/home-away.

Query Parameters

Team offense/defense/special-teams season totals, including opponent-mirror fields.

Query Parameters

Weekly result ledger — every game in that week graded hit/miss/pending against its frozen pregame prediction, plus previous/next graded-week navigation.

Query Parameters

Completed, prediction-bearing NFL weeks eligible for public recap discovery and sitemap inclusion. Includes the prediction-history start date and each week's last game date.

Daily NFL Summary with matchups, spread, total, win confidence, rest, injuries, and projection factors. Dates follow the Eastern kickoff calendar.

Access: Authenticated

Parameters

date: optional valid YYYY-MM-DD; defaults to today in Eastern time. Current projections before kickoff; stored pregame confidence and factors after kickoff. Missing historical predictions stay unavailable. Historical lines are closing pregame DraftKings quotes. NFL uses Breakdown and Injuries, without Stack or an overtime estimate.

Response overview

{ date, games, slateOverview, slateEdge }

Player form, projections, and matchup signals for the current or next available slate.

Access: Authenticated; playerSignals entitlement

Parameters

stat: passing_yards (default), passing_tds, passing_completions, rushing_yards, rushing_attempts, receiving_yards, or receptions. The slate date is selected automatically.

Response overview

{ date, stat, games, players }

Leads: players whose recent average meets or exceeds the consensus prop line. Always uses consensus, with no sportsbook fallback.

Access: Authenticated; results limited by plan

Parameters

propType: passing_yards (default), passing_tds, passing_completions, rushing_yards, rushing_attempts, receiving_yards, receptions, rushing_receiving_yards, or anytime_td. lookback: 5 (default), 10, 20, or season. date: YYYY-MM-DD, default today. tzOffsetMin: minutes east of UTC, -720 to 840, default 0. fallback: next to find the next available prop date. vendor does not select a book; marketScope is always consensus.

Response overview

{ players, updatedAt, marketScope: "consensus", ...date and plan metadata }

Player directory with season summaries and a recent-form list.

Access: Public

Parameters

season: optional 2000-2100; defaults to the current NFL season.

Response overview

{ sport: "nfl", season, totalPlayers, players, hot }

Combined player identity, injury, regular-season stats, recent game log, and roster. Optional sections may be unavailable while the profile still succeeds.

Access: Public

Parameters

playerId: internal player ID. season: optional; defaults to the current calendar year.

Response overview

{ player, injury, stats, gameLog, roster }

Team directory with records and season summaries.

Access: Public

Parameters

season: optional 2000-2100; defaults to the current NFL season. seasonType: 1 preseason, 2 regular season (default), or 3 postseason.

Response overview

Team hub with season, seasonType, and team summaries.

League-wide team rankings by statistical category.

Access: Public

Parameters

season: optional; defaults to the current NFL season. seasonType: 1 preseason, 2 regular season (default), or 3 postseason.

Response overview

{ totalTeams, categories, teams, ...ranking metadata }

Combined team record, home/away splits, streak, scoring, spread and total results, division standings, rankings, and schedule.

Access: Public

Parameters

teamId: internal team ID. season: optional; defaults to the current NFL season. seasonType: 1 preseason, 2 regular season (default), or 3 postseason. The schedule includes all season types; result summaries use the requested type.

Response overview

{ team, season, seasonType, gamesPlayed, record, home, away, streak, ats, overUnder, division, rankings, schedule, ...scoring fields }

Aggregate suspect votes and the current user's vote, keyed by playerId_propType. An unknown game returns an empty votes object.

Access: Authenticated

Parameters

nflGameId: provider NFL game ID, not the internal game ID.

Response overview

{ gameId, votes: { "123_passing_yards": { upvotes: 1, downvotes: 0, userVote: 1 } } }

Cast a suspect vote. Repeating the same vote cancels it; voting in the opposite direction switches it. Unknown game returns 404.

Access: Authenticated

Parameters

nflGameId: provider NFL game ID. playerId: internal player ID. JSON body: propType (required string), vote (required numeric 1 or -1).

Request body

{
  "propType": "passing_yards",
  "vote": 1
}

Response overview

{ playerId, propType, upvotes, downvotes, userVote }

Override whether a rostered player belongs to the team's core lineup. Refreshes the roster cache. A player outside this roster returns 404.

Access: Admin only

Parameters

teamId and playerId: internal IDs. JSON body: isCore, optional boolean, default true; other types return 400.

Request body

{
  "isCore": true
}

Response overview

{ teamId, playerId, isCore, source: "override" }

Remove a core-player override and restore automatic selection. Refreshes the roster cache.

Access: Admin only

Parameters

teamId and playerId: internal IDs. No request body.

Response overview

{ teamId, playerId, source: "usage" }

Daily games with records, scores, status, venue, and matchup projections.

Behavior: No pagination. engine is live before puck drop, frozen after start, or null when unavailable.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/today?date=2026-10-12&fallback=next"

{
  "date": "2026-10-12",
  "requestedDate": "2026-10-12",
  "fallbackDate": null,
  "timezone": "America/New_York",
  "tzOffsetMin": null,
  "games": []
}

Completed games, newest first, with the matching total count.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/results?season=2026&postseason=false"

{
  "season": 2026,
  "postseason": false,
  "games": [],
  "total": 0,
  "limit": 50,
  "offset": 0
}

One game, returned directly rather than inside a games array.

Behavior: Includes scores, records, venue, and the current/frozen engine. Missing game returns 404.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11"

{
  "id": 1,
  "nhl_game_id": 11,
  "season": 2026,
  "status_state": "scheduled",
  "engine": null
}

Skater and goalie box-score rows for one game.

Behavior: participation is recorded, no_recorded_ice_time, or unknown. Empty rows do not imply zero statistics.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/stats"

{
  "game": {
    "nhl_game_id": 11
  },
  "players": [],
  "source": "provider_box_scores",
  "feed_observation": null,
  "retained_after_empty": false
}

Play-by-play and a full-feed live-center summary.

Behavior: Summary includes period scoring, overtime/shootout context, penalties, team totals, and leaders. Participant IDs in play details are provider player IDs.

curl -X GET "https://app.sportsfbi.com/api/nhl/plays/11?period=1"

{
  "game": {
    "nhl_game_id": 11
  },
  "plays": [],
  "periods": [],
  "feed_coverage": {},
  "source": "provider_play_by_play",
  "summary": {
    "scoring": {},
    "scoring_plays": [],
    "penalties": [],
    "team_stats": {},
    "leaders": {},
    "unavailable": [
      "win_probability",
      "expected_goals",
      "shift_time",
      "power_play_labels"
    ]
  }
}

All stored team identities, including historical teams.

No query parameters or body.

curl -X GET "https://app.sportsfbi.com/api/nhl/teams"

{
  "teams": []
}

Season teams, regular-season standings, recent form, and per-stat rankings.

curl -X GET "https://app.sportsfbi.com/api/nhl/teams/hub?season=2026"

{
  "sport": "nhl",
  "season": 2026,
  "postseason": false,
  "totalTeams": 0,
  "teams": []
}

Team rankings from standings and official season aggregates.

curl -X GET "https://app.sportsfbi.com/api/nhl/team-rankings?season=2026"

{
  "season": 2026,
  "postseason": false,
  "totalTeams": 0,
  "method": "per_metric_competition_rank",
  "categories": [],
  "teams": []
}

Identity, standings, division, rankings, and full season schedule.

Behavior: Standings and ranks use regular-season data. Schedule also includes postseason games. ATS and total records remain unavailable.

curl -X GET "https://app.sportsfbi.com/api/nhl/team/1/profile?season=2026"

{
  "team": {
    "id": 1
  },
  "season": 2026,
  "standing": null,
  "recordText": null,
  "division": {
    "rows": []
  },
  "rankings": {},
  "ats": null,
  "overUnder": null,
  "betting_results_unavailable_reason": "settlement_scope_unresolved",
  "schedule": []
}

Season games in date order, with opponent and home/away identity.

curl -X GET "https://app.sportsfbi.com/api/nhl/team/1/schedule?season=2026&postseason=false"

{
  "team": {
    "id": 1
  },
  "season": 2026,
  "games": []
}

Season-associated roster, current injuries, core overrides, and official regular-season player stats.

Behavior: Season membership does not confirm game participation or line combinations.

curl -X GET "https://app.sportsfbi.com/api/nhl/team/1/roster?season=2026"

{
  "team": {
    "id": 1
  },
  "season": 2026,
  "players": [],
  "stats_source": "provider_season_stats",
  "injury_source": "current_report",
  "membership_type": "season_association",
  "lineup_confirmed": false
}

Stored provider standings for a team and season.

Behavior: standing is null when no row is stored.

curl -X GET "https://app.sportsfbi.com/api/nhl/team/1/standings?season=2026"

{
  "team": {
    "id": 1
  },
  "season": 2026,
  "standing": null
}

Current injuries attributed through the injury feed's season associations.

Behavior: Current report, not a historical report reconstructed for a past game.

curl -X GET "https://app.sportsfbi.com/api/nhl/team/1/injuries?season=2026"

{
  "team": {
    "id": 1
  },
  "season": 2026,
  "injuries": [],
  "report_type": "current",
  "team_attribution": "injury_feed_season_association"
}

Observed starters from finals, grouped by goalie with individual starts.

Behavior: Includes regular-season and postseason finals. This is postgame evidence, not pregame confirmation.

curl -X GET "https://app.sportsfbi.com/api/nhl/team/1/goalie-starts?season=2026"

{
  "team": {
    "id": 1
  },
  "season": 2026,
  "observation": "postgame_box_score_starter",
  "pregame_confirmation": false,
  "coverage": {
    "final_games": 0,
    "games_with_observed_starter": 0
  },
  "goalies": [],
  "starts": []
}

Expected or observed confirmed goalie for each side, with official season stats.

Behavior: status is expected, confirmed, or unavailable. Expected uses prior starts/rest; confirmed uses a box-score starter flag, not an external pregame confirmation feed.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/goalies"

{
  "nhl_game_id": 11,
  "home": {
    "status": "unavailable",
    "goalie": null,
    "basis": "no_prior_starts",
    "detail": null
  },
  "away": {
    "status": "unavailable",
    "goalie": null,
    "basis": "no_prior_starts",
    "detail": null
  },
  "pregame_confirmation": false
}

Search stored players by name and optional season association.

curl -X GET "https://app.sportsfbi.com/api/nhl/players?q=Skater&season=2026"

{
  "players": [],
  "limit": 50,
  "offset": 0
}

Associated players, teams, regular-season stats, and current injuries.

Behavior: Traded players can have multiple team associations.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/hub?season=2026"

{
  "sport": "nhl",
  "season": 2026,
  "postseason": false,
  "players": []
}

Player identity and all stored season team memberships.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7"

{
  "player": {
    "id": 7,
    "nhl_player_id": 70
  },
  "memberships": [],
  "membership_type": "season_association"
}

Player identity, memberships, injury, season stats, and the latest ten game logs.

Behavior: Stats are regular-season aggregates. Logs can include postseason games in that season. role is skater, goalie, or null.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7/public-profile?season=2026"

{
  "player": {
    "id": 7
  },
  "season": 2026,
  "role": "skater",
  "memberships": [],
  "injury": null,
  "stats": {
    "postseason": false,
    "values": {},
    "source": "provider_season_stats"
  },
  "gameLog": {
    "rows": [],
    "source": "provider_box_scores"
  }
}

Paginated player box scores, newest first, with opponent at each game.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7/game-log?season=2026&postseason=false"

{
  "player": {
    "id": 7
  },
  "season": 2026,
  "rows": [],
  "limit": 50,
  "offset": 0,
  "source": "provider_box_scores"
}

Official season stats, or box-score rows for one game.

Behavior: With gameId, response is player_id, nhl_game_id, rows, and source: provider_box_scores. This query uses gameId; player prop readers use game_id.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7/stats?season=2026&postseason=false"

{
  "entity": {
    "id": 7,
    "provider_id": 70
  },
  "season": 2026,
  "postseason": false,
  "stats": [],
  "values": {},
  "source": "provider_season_stats",
  "feed_observation": null,
  "retained_after_empty": false
}

{
  "player_id": 7,
  "nhl_game_id": 11,
  "rows": [],
  "source": "provider_box_scores"
}

Scopes with stored official statistics.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7/seasons"

{
  "player_id": 7,
  "seasons": [
    {
      "season": 2026,
      "postseason": false
    }
  ],
  "source": "stored_official_season_stats"
}

Official team aggregates and source observations.

curl -X GET "https://app.sportsfbi.com/api/nhl/team/1/season-stats?season=2026&postseason=false"

{
  "entity": {
    "id": 1,
    "provider_id": 10
  },
  "season": 2026,
  "postseason": false,
  "stats": [],
  "values": {},
  "source": "provider_season_stats",
  "feed_observation": null,
  "retained_after_empty": false
}

Official player leaderboard, preserving provider order.

Behavior: Rows expose internal id and provider_id. source_rows_for_entity identifies repeated provider entries; they are not combined into invented totals.

curl -X GET "https://app.sportsfbi.com/api/nhl/player_stats/leaders?season=2026&type=points"

{
  "season": 2026,
  "postseason": false,
  "type": "points",
  "rows": [],
  "limit": 100,
  "offset": 0,
  "ordering": "provider_order",
  "source": "provider_stat_leaders"
}

Official team leaderboard, preserving provider order.

Behavior: Rows expose internal id and provider_id. source_rows_for_entity identifies repeated provider entries; they are not combined into invented totals.

curl -X GET "https://app.sportsfbi.com/api/nhl/team_stats/leaders?season=2026&type=points"

{
  "season": 2026,
  "postseason": false,
  "type": "points",
  "rows": [],
  "limit": 100,
  "offset": 0,
  "ordering": "provider_order",
  "source": "provider_stat_leaders"
}

Active game lines for selected games or one slate.

curl -X GET "https://app.sportsfbi.com/api/nhl/betting-odds?gameIds=11&vendor=fanduel"

{
  "odds": [],
  "market_scope": "provider_game"
}

Current, official opening, and observed pregame closing game lines.

Behavior: pregame_closing is null before start and an array afterwards. closing_basis is not_started, observed_pregame_history, or unavailable. Current lines can be live in-game prices after puck drop.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/markets?vendor=fanduel"

{
  "game": {
    "nhl_game_id": 11
  },
  "current": [],
  "opening": [],
  "pregame_closing": null,
  "market_scope": "provider_game",
  "closing_basis": "not_started"
}

Locally observed material line changes, oldest first, plus current/opening/closing views.

Behavior: Local collection history is not a complete historical sportsbook feed. Withdrawal rows are preserved.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/odds-history?vendor=fanduel&limit=200"

{
  "game": {
    "nhl_game_id": 11
  },
  "history": [],
  "limit": 200,
  "offset": 0,
  "source": "local_observed_material_changes",
  "current": [],
  "opening": [],
  "pregame_closing": null
}

All active offers for a game, across books and alternate ladders.

Behavior: No vendor filter or pagination. Current offers after start can be live in-game prices.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/player-props" -H "Authorization: Bearer YOUR_API_KEY"

{
  "game": {
    "nhl_game_id": 11
  },
  "props": [],
  "source": "provider_current_quotes"
}

Last locally observed active pregame quote for each distinct offer.

Behavior: Before start props is null/not_started; missing start returns null/unavailable. Both source update and observation must predate start; withdrawn offers are excluded.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/player-props/closing?vendor=fanduel" -H "Authorization: Bearer YOUR_API_KEY"

{
  "game": {
    "nhl_game_id": 11
  },
  "props": [],
  "closing_basis": "unavailable",
  "alternative_lines_are_distinct": true,
  "settlement_rules": null
}

Current and immutable opening quotes for a player in a game.

Behavior: Prop rows include quote_key, vendor, prop_type, market_type, line_value, over_odds, under_odds, milestone_odds, active, source_updated_at, observed_at. Game-wide offers can have a null internal player mapping.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7/props?game_id=11&vendor=fanduel"

{
  "player": {
    "id": 7,
    "nhl_player_id": 70
  },
  "game": {
    "nhl_game_id": 11
  },
  "props": [],
  "opening": []
}

Observed offer history, optionally restricted to one exact quote.

Behavior: Requires premiumData (Pro/Elite app tiers). Ascending observed order. Different lines remain distinct; history includes withdrawals.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7/props/line-movement?game_id=11&prop_type=shots_on_goal" -H "Authorization: Bearer YOUR_API_KEY"

{
  "player": {
    "id": 7
  },
  "game": {
    "nhl_game_id": 11
  },
  "history": [],
  "limit": 200,
  "offset": 0,
  "source": "local_observed_offer_history",
  "alternative_lines_are_distinct": true
}

Frozen player pick performance and a separate all-offer baseline.

Behavior: Requires premiumData. Strict scope filtering, no fallback. History retains individual frozen offer records; decided denominator is HIT + MISS. Newest games first.

curl -X GET "https://app.sportsfbi.com/api/nhl/players/7/props/hit-rate?season=2026&postseason=false&marketScope=consensus" -H "Authorization: Bearer YOUR_API_KEY"

{
  "marketScope": "consensus",
  "player": {
    "id": 7
  },
  "season": 2026,
  "postseason": false,
  "selected_picks": {
    "hits": 0,
    "misses": 0,
    "pushes": 0,
    "voids": 0,
    "unresolved": 0,
    "decided": 0,
    "hit_rate": null
  },
  "all_offers": {
    "captured": 0,
    "graded": 0
  },
  "history": [],
  "limit": 200,
  "offset": 0
}

Current pregame analysis, or frozen prediction with actual outcome.

Behavior: No recomputation after start; missing capture is explicit. The 3+ goal model is uncalibrated.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/analysis"

{
  "frozen": false,
  "model_version": "nhl-game-v2",
  "capture_missing": true,
  "derivation": null,
  "derivation_unavailable_reason": "no_pregame_capture",
  "outcome": null
}

Stored/generated AI preview, or factual early/fallback analysis.

Behavior: AI responses include preview_text; early/fallback responses use fallback_narrative. Cached text can be served after start; otherwise alreadyStarted: true. Concurrent generation returns 202 with inProgress: true. Requests may generate content.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/preview"

{
  "tooEarly": true,
  "fallback_narrative": [],
  "fallback_quick_facts": []
}

{
  "inProgress": true
}

{
  "alreadyStarted": true
}

Recap of a final game, using AI text or a factual fallback.

Behavior: 400 before final; 202/inProgress during concurrent generation. AI recaps require a tracked pregame prediction; backfilled history uses factual fallback. Requests may generate content.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/recap"

{
  "fallback": true,
  "recap_text": "Illustrative factual recap."
}

Highest-scoring supported prop per player with historical and matchup evidence.

Behavior: Current offers/prior finals before start, frozen snapshots afterwards. No selected consensus picks means all_books fallback with consensusFallback: true; availability filtering never triggers fallback and does not filter book fallback. Missing capture is flagged. Scores are not hit probabilities.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/key-suspects?marketScope=consensus"

{
  "marketScope": "consensus",
  "consensusVersion": 1,
  "consensusFallback": false,
  "frozen": false,
  "totalAvailable": 0,
  "suspects": [],
  "evidence_score_is_probability": false
}

{
  "marketScope": "consensus",
  "consensusVersion": 1,
  "consensusFallback": true,
  "fallbackVendor": "all_books",
  "frozen": true,
  "source": "pregame_capture",
  "captured_at": null,
  "captured_offers": 0,
  "capture_missing": true,
  "totalAvailable": 0,
  "suspects": []
}

Form estimates and opponent-matchup context on the current/next slate.

Behavior: Requires playerSignals (all signed-in app tiers). No date query. Estimates use prior finals and are not calibrated hit probabilities.

curl -X GET "https://app.sportsfbi.com/api/nhl/slate/signals?stat=shots_on_goal" -H "Authorization: Bearer YOUR_API_KEY"

{
  "date": "2026-10-12",
  "stat": "points",
  "players": [],
  "games": []
}

Consensus Leads comparing prior performance with accepted canonical pregame prop lines.

Behavior: Consensus only, no book fallback. Each row includes contributing books and probability; overOdds is an available quote at the canonical line, identified by executionVendor. Canonical opening/line movement are unavailable. Free app accounts see WATCH/RISK; paid accounts see all tiers. Started games excluded.

curl -X GET "https://app.sportsfbi.com/api/nhl/slate/value-plays?propType=shots_on_goal&marketScope=consensus&lookback=20" -H "Authorization: Bearer YOUR_API_KEY"

{
  "players": [],
  "updatedAt": null,
  "marketScope": "consensus",
  "vendor": "consensus",
  "date": "2026-10-12"
}

Market-derived EV at an identical line, before puck drop.

Behavior: Game lines for signed-in accounts; player props require evPlayerProps (Pro/Elite). At least two other reference books and supported two-sided props only. EV is conditional on no push. NHL game-line Radar settlement is unavailable.

curl -X GET "https://app.sportsfbi.com/api/nhl/slate/ev?date=2026-10-12" -H "Authorization: Bearer YOUR_API_KEY"

{
  "date": "2026-10-12",
  "games": [],
  "propsEnabled": true,
  "gameLinesRadar": false,
  "maxQuoteAgeMinutes": 90,
  "opportunities": [],
  "coverage": {}
}

Consensus Cases priced at real sportsbook quotes at the canonical line, with distinct players.

Behavior: Consensus by default. If a game has no selected consensus picks, uses the requested fallback sportsbook for that game and reports fallback metadata. Fair consensus reference odds are not executable prices. Case count follows account allowance. No calibrated parlay probability supplied.

curl -X GET "https://app.sportsfbi.com/api/nhl/slate/case-builder?vendor=fanduel&legs=4" -H "Authorization: Bearer YOUR_API_KEY"

{
  "gamesAvailable": [],
  "marketScope": "consensus",
  "vendor": "fanduel",
  "executionPolicy": "best_canonical_price_per_leg",
  "modelBasis": "ranked_evidence_no_probability",
  "cases": [],
  "consensusFallback": false,
  "consensusFallbackGames": 0,
  "consensusGamesTotal": 0,
  "fallbackVendor": null
}

Daily matchup overview: puck lines, goal-margin bands, rest, injuries, expected goals.

Behavior: Frozen analysis and pregame closing lines after start. Goal bands mean 3+ goals including overtime, not calibrated confidence.

curl -X GET "https://app.sportsfbi.com/api/nhl/slate/summary?date=2026-10-12"

{
  "date": "2026-10-12",
  "model_version": "nhl-game-v2",
  "calibrated": false,
  "slateOverview": {
    "totalGames": 0
  },
  "slateEdge": null,
  "games": []
}

Daily Hitlist, or season history/totals when season is supplied.

Behavior: Requires premiumData. Daily consensus fallback is per game. Started games without captures are counted, never reconstructed. Season mode returns season, history, selected, by_prop, all_offers, limit, offset; strict scope without fallback. date ignored in season mode.

curl -X GET "https://app.sportsfbi.com/api/nhl/slate/hit-rate?date=2026-10-12&marketScope=consensus" -H "Authorization: Bearer YOUR_API_KEY"

{
  "date": "2026-10-12",
  "marketScope": "consensus",
  "suspects": [],
  "total": 0,
  "gamesFound": 0,
  "frozenGames": 0,
  "liveGames": 0,
  "captureMissingGames": 0,
  "consensusFallback": false,
  "consensusFallbackGames": 0,
  "consensusGamesTotal": 0,
  "summary": {
    "hits": 0,
    "misses": 0,
    "pushes": 0,
    "voids": 0,
    "ungraded": 0,
    "decided": 0,
    "hit_rate": null
  }
}

{
  "season": 2026,
  "postseason": false,
  "marketScope": "consensus",
  "history": [],
  "selected": {
    "HIT": 0,
    "MISS": 0,
    "PUSH": 0,
    "VOID": 0,
    "ungraded": 0,
    "hit_rate": null,
    "hit_rate_denominator": "HIT + MISS (PUSH and VOID excluded)"
  },
  "by_prop": [],
  "all_offers": [],
  "limit": 25,
  "offset": 0
}

Completed slate dates with frozen predictions for recap discovery.

No query parameters or body.

curl -X GET "https://app.sportsfbi.com/api/nhl/stats/slate-recap-dates"

{
  "dates": []
}

Daily results against frozen game predictions and selected prop tallies.

Behavior: Strict prop scope, no fallback; unique picks count once within scope. Results include upset flags, overtime/shootout labels, and previous/next completed slate dates.

curl -X GET "https://app.sportsfbi.com/api/nhl/stats/slate-recap?date=2026-10-12&marketScope=consensus"

{
  "date": "2026-10-12",
  "marketScope": "vendor",
  "totalGames": 0,
  "predictionsGraded": 0,
  "hits": 0,
  "misses": 0,
  "accuracyPct": null,
  "suspects": null,
  "results": []
}

Aggregated votes and the requesting account's own vote, keyed by player/prop.

Behavior: Missing game returns an empty votes object rather than 404.

curl -X GET "https://app.sportsfbi.com/api/nhl/games/11/suspects/votes" -H "Authorization: Bearer YOUR_API_KEY"

{
  "gameId": 11,
  "votes": {
    "7_shots_on_goal": {
      "upvotes": 1,
      "downvotes": 0,
      "userVote": 1
    }
  }
}

Cast or toggle a vote before puck drop.

Behavior: Repeating the same vote cancels it (0); opposite vote replaces it. 409 at puck drop; 400 for unsupported inputs.

curl -X POST "https://app.sportsfbi.com/api/nhl/games/11/suspects/7/vote" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"propType":"shots_on_goal","vote":1}'

{
  "playerId": 7,
  "propType": "shots_on_goal",
  "upvotes": 1,
  "downvotes": 0,
  "userVote": 1
}

Set a roster core-player override.

Behavior: Administrator only. Player must have a season association with the team; missing association returns 404.

curl -X PUT "https://app.sportsfbi.com/api/nhl/team/1/core-players/7" -H "Authorization: Bearer YOUR_ADMIN_API_KEY" -H "Content-Type: application/json" -d '{"isCore":true}'

{
  "teamId": 1,
  "playerId": 7,
  "isCore": true,
  "source": "override"
}

Remove a core-player override.

curl -X DELETE "https://app.sportsfbi.com/api/nhl/team/1/core-players/7" -H "Authorization: Bearer YOUR_ADMIN_API_KEY"

{
  "teamId": 1,
  "playerId": 7,
  "isCore": null,
  "source": "none"
}

Refresh job status, attempts, successes, staleness, and errors.

No query parameters or body.

Behavior: Read-only; does not trigger refresh jobs.

curl -X GET "https://app.sportsfbi.com/api/nhl/system/refresh-status" -H "Authorization: Bearer YOUR_ADMIN_API_KEY"

{
  "jobs": [],
  "expected_jobs": [],
  "conditional_jobs": []
}

Worker, source freshness, capture coverage, unresolved grades, and live-game health.

No query parameters or body.

curl -X GET "https://app.sportsfbi.com/api/nhl/system/health" -H "Authorization: Bearer YOUR_ADMIN_API_KEY"

{
  "worker": {
    "jobs": 0,
    "failed": 0,
    "stale": 0,
    "heartbeat_age_seconds": null
  },
  "source_age_seconds": {},
  "capture_coverage": {
    "window_days": 7,
    "started_games": 0,
    "with_game_prediction": 0,
    "with_prop_capture": 0
  },
  "unresolved_grades": {
    "count": 0,
    "oldest_game_date": null,
    "after_hours": 6
  },
  "live_games": 0
}

List of matches for a given date, each with team info, stadium, and primary-vendor odds attached.

Query Parameters

Full match detail — events, lineups, team stats, best players, odds from every vendor, shot map (xG/xGOT), per-minute momentum, and head-to-head history.

Tournament and group winner futures odds, grouped by market.

Query Parameters

Full match odds — 3-way moneyline, spread, and total per vendor, plus exotic markets and their outcomes.

Query Parameters

Player prop odds (milestone/over/under) for a single match.

Query Parameters

All teams with their current group-stage standing for the season.

Query Parameters

Team detail — group standing, full roster with aggregated tournament stats, all matches, average team stats, and current manager.

Query Parameters

Search or list players by name, team, or position.

Query Parameters

Player detail (bio, team) plus every match's stat line for the player this season.

Query Parameters

Group-stage standings grouped by group letter.

Query Parameters

Knockout-stage bracket, grouped by round (Round of 32 through Final) in bracket order.

Query Parameters

Tournament-wide statistical leaderboard for a chosen stat, top 100.

Query Parameters

Six pre-match betting-edge signals per upcoming match — xG Edge, Possession, Set Piece, Press Intensity, Form, and Late Momentum — each with a winner, tag, and implication.

Query Parameters

Weighted 0–100 Suspicion Score per player prop for a match, with an evidence breakdown, trend, and sparkline.

Query Parameters

Player prop value plays for upcoming matches — players whose season hit rate/average beats the prop line, sorted by ratio.

Query Parameters

Players currently on active consecutive-match statistical streaks (minimum length 2).

Query Parameters

Projected starting XI and bench for both teams based on this season's formation and starter frequency, with tournament-average stats per player.

Query Parameters

For all completed matches on a target date, compares each player prop line to the actual result and returns HIT/MISS per player.

Query Parameters

Pre-match context for both teams — last-5-match form, season momentum profile, top-3 key players per side, and head-to-head history.

Query Parameters

Today's NCAAB games with team info, scores, status, and game quality ratings.

Query Parameters

Spreads, moneylines, and totals for NCAAB games.

Query Parameters

Starting lineups, bench players, injuries, and team standings for a specific game.

A single player's box score for a specific game.

Play-by-play data organized by half.

Key Suspects analysis for NCAAB — college players likely to exceed projections based on matchup and usage context.

Player profile (name, position, height, weight, team, jersey number).

List of seasons the player has box-score data for.

Game-by-game statistics for a NCAAB season.

Query Parameters

Season averages for a NCAAB player.

Query Parameters

A player's last-10-game averages compared against an opponent's defensive profile, with generated insight strings and an overall verdict.

NCAAB team schedule with results and upcoming games.

Query Parameters

Full team roster with player positions, jersey numbers, and current-season per-game averages.

Team's individual per-game box scores for a season, newest first.

Query Parameters

Team statistics including PPG, PAPG, pace, and offensive/defensive breakdowns.

Query Parameters

Statistical leaderboards for NCAAB — live, daily, or season modes.

Query Parameters