feed your machine

source-readiness

Connection, latency, licensing and redistribution contract.

[RECOMMENDED_STACK]

nflverse + espn + pff + sharp + the_odds_api + nws for the initial product; ESPN supplies connected no-key live state with a second free score feed as a cross-check. PFF and Sharp stay private enrichment; Sportradar or Genius remains the production low-latency upgrade.

[FEEDS]
nflverse ingestedrole=historical results and features · access=open · latency=nightly in season · datasets_present=depth_charts,injuries,pbp,player_stats,players,schedules,snap_counts
pfr_via_nflverse ingestedrole=historical validation and advanced stats · access=open_redistribution_path · latency=postgame · datasets_present=pfr_def,pfr_pass,pfr_rec,pfr_rush
espn readyrole=free live scores, play-by-play and injuries · access=no_key_unofficial · latency=poll every 15-30 seconds in-game · datasets_present=none
the_odds_api ingestedrole=market prices, player-prop lines and championship futures · access=api_key · latency=polling · datasets_present=futures_quotes,market_quotes,odds_events,prop_quotes
prediction_markets ingestedrole=exchange-traded contract prices as probabilities · access=no_key_public_read · latency=polling · datasets_present=prediction_quotes
nws readyrole=stadium forecasts and observations · access=open · latency=hourly forecast updates · datasets_present=none
mysportsfeeds credential_requiredrole=live score and play-by-play redundancy · access=free_private_use_or_paid · latency=real time · datasets_present=none
balldontlie credential_requiredrole=free score and game-state backup · access=free_api_key · latency=5 requests/minute on free tier · datasets_present=none
api_sports_nfl credential_requiredrole=low-frequency live health check · access=free_api_key · latency=100 requests/day on free tier · datasets_present=none
bigballsdata credential_requiredrole=hosted nflverse and 2026 live scores · access=free_api_key · latency=1,000 requests/day · datasets_present=none
sleeper readyrole=fantasy identity, rosters and NFL state · access=open_no_key · latency=near real time · datasets_present=none
big_data_bowl readyrole=historical player-tracking features · access=free_kaggle_account · latency=annual archive · datasets_present=none
spreadspoke readyrole=long-run scores, lines, totals and weather · access=free_download · latency=periodic · datasets_present=none
nflsavant readyrole=historical play-by-play cross-check · access=free_download · latency=season archive · datasets_present=none
pff private_connectedrole=grades and charting enrichment · access=account_authenticated_private · latency=browser snapshot · datasets_present=pff_grades
sharp private_connectedrole=expert priors and market context · access=account_authenticated_private · latency=browser snapshot · datasets_present=sharp_signals
sportradar license_requiredrole=live play-by-play and availability · access=enterprise_license · latency=streaming push · datasets_present=none
genius license_requiredrole=official NFL play-by-play and Next Gen Stats · access=enterprise_license · latency=low-latency stream · datasets_present=none
rotowire license_requiredrole=injuries, depth charts and player news · access=enterprise_license · latency=minutes · datasets_present=none
[OPERATIONS]
GET /v1/sourcesmachine-readable version of this state
RUN uv run python scripts/ingest_live.py --source odds --propsmarket and prop snapshots
RUN uv run python scripts/ingest_live.py --source weather --days 8outdoor-stadium hourly forecasts
RUN uv run python scripts/ingest_live.py --source espnno-key live scores, plays and injuries
GET /v1/private/enrichment?game_id=...PFF and Sharp context; requires x-fbdata-private-token