Changelog
The newest releases. Changes merged since 0.2.0b1 are under Unreleased; older releases are in the archive.
0.2.0b1 Release: October 26, 2026
Highlights
0.2.0b1 is the beta of 0.2.0, the first release since 0.1.4 (0.1.5 was never published; its changes are folded
in here). Install it with pip install --pre sportsdataverse; the 0.2.0 migration guide
covers the sixteen breaking changes.
- Failed fetches raise.
AssetFetchError(the fetch failed),NoDataError(nothing there) andValueError(a bad request) replace empty frames across ESPN, stats.nba.com, the generated flat APIs and HockeyTech. - polars 2 and Int64 ids. polars
>=2.0,<3is required, and parser id columns are Int64 at the boundary. - A reorganised package. Side leagues and EuroLeague live under
sportsdataverse.basketball, cross-sport providers undersportsdataverse.providers, and the analytics helpers undersportsdataverse.analytics; the old import paths warn and keep working until 0.4.0. The G League gains its ownnbagl_stats_*wrappers. - New sources. The PFF Developer API, Formula 1, EuroLeague, 24 international basketball and 12 European hockey families, kloppy soccer event data with SPADL and Expected Threat, Polymarket and Kalshi.
- A rebuilt docs site. Pages titled by league name, returns tables in polars types, grouped leagues on the home
page, new sdvplot charts in the tutorials, and an MCP docs server (
sportsdataverse[mcp]).
Breaking changes
- 247Sports site pages:
primary_color,jerseyandpostal_codeare String (were Int64 when every value was digits, so event"000000"was0); a (0, 0)latitude/longitudepair, 247's no-location sentinel, is null. (#928) build_nfl_seasoncache:PIPELINE_VERSIONis 2, so per-game frames cached earlier (String*_player_id, Int32pos_team) are rebuilt instead of concatenated with the new Int64 ones, wherediagonal_relaxedwould turn those columns back into String. (#981)fox_nfl_pbp/fox_cfb_pbp:play_teamis now the club code of the drive group the play is filed under (e.g."NYG"); it held the name of the player Fox credits the play to, which moves to the newplay_playercolumn. (#922)ncaa_{mbb,wbb}_play_by_play/ncaa_{mbb,wbb}_box_scoresraiseAssetFetchErrorwhen a fetch fails (a ban, an exhausted pool, an uncleared challenge) instead of dropping that game, which made a ban read as a smaller season;errors="skip"keeps going and adds ascrape_statuscolumn with one row per dropped game saying why. (#924)nfl.update_config(cache_mode=...)raisesValueErrorfor a mode other than"memory","filesystem"or"off"(an unknown mode used to switch caching off silently). (#899)nfl_players_crosswalk()raisesAssetFetchErrorwhen the nflverse players master cannot be fetched; it used to return a zero-row frame ("never a raise"), which nulled every id in a join. An absent asset still gives zero rows, and a failed DynastyProcess load now warns (yahoo/cbs ids null). (#899)nhl_player_props/pwhl_player_props:game_idandplayer_idareInt64(were Utf8), so the props join the NHL parser / EDGE and HockeyTech frames onplayer_id; compare them to ints (player_id == 8478402). (#986)- Bart Torvik:
torvik_player_stats()/parse_torvik_player_stats()returnnumberas String (was Int64); the 8"00"jerseys of 2025 no longer merge into the 2910rows. (#928) - Basketball-Reference:
bref_team_roster()returnsnumberas String (was Float64), so Robert Parish's"00"is no longer0.0; any other zero-padded column also stays String. (#928) - ESPN game rosters:
espn_<lg>_game_rosters(raw=True)(mbb, wbb, nba, wnba, nfl, nhl, cfb) returns the Core v2 competitors payload (a dict);raw=was accepted and ignored, so it returned the parsed frame. (#878) - ESPN hand-written families:
espn_<lg>_schedule(id,game_id,*_id,home_/away_id,*_venue_id,*_conference_id,groups_id;game_idwas Int32),espn_<lg>_teams(team_id) andespn_<lg>_game_rosters(every*_id;team_id/game_id/position_idwere Int32) areInt64. (#981) - ESPN parsers: every
id/*_idcolumn from_common_espn_parsers(theespn_<lg>_<short>wrappers) isInt64, where it was String, or Float64 when the pandas hop met a missing value, soparse_fpijoinsparse_weekly_powerindex;now_id("1-44686270") is not an integer and stays String. (#981) - ESPN parsers: not yet in this release are the soccer leagues'
scoreboard,standings,summary,teams_siteandteam_rosterand the cricket leagues'scoreboard,standingsandsummarywrappers, whose parsers do not cast: their ids stay String; those leagues' other wrappers (news,injuries, ...) areInt64. (#981) - ESPN schedules: the six copies that sent
seasonTypenow sendseasontype. ESPN ignored the camelCase key, soseason_type=withdates=YYYY&week=N(NFL, NHL, WNBA, NBA, MBB, WBB) never filtered; it does now, and those calls return different rows. (#855) - ESPN snapshots / content / crosswalks:
espn_injuries_snapshot/espn_depthcharts_snapshotids, theparse_espn_contentidandncaa_espn_team_crosswalkespn_team_id/espn_conference_idareInt64(were Utf8);load_{nba,wnba,mbb,wbb}_{team,player,schedule}_crosswalkcast theirespn_*ids toInt64. (#981) - ESPN snapshots: the injuries / depth-chart snapshots read an id that is not an integer (text,
"007") as null with aSchemaDriftWarningnaming the field. (#981) - ESPN, pandas output: with
return_as_pandas=Truethe same ids are pandas' nullableInt64(wasobject, orfloat64such as150.0where a value was missing); the Arrow-backedparse_fpi,parse_weekly_powerindexand the generatedload_*_crosswalkloaders carry them asint64[pyarrow]. (#981) - ESPN:
espn_<league>_leaders()drops its one-row envelope columns (pagination_*,league_*,current_season_*, theathletes/glossary/categoriescells) for one row per athlete; leagues without a leaderboard give zero rows. Page counts and ESPN's per-stat ranks stay inreturn_parsed=False. (#1018) - HockeyTech: game-summary
home_team_id/away_team_id/game_season_idare null, not"", when unavailable; pandas output carries nullableInt64(wasfloat64such as1.0, orstr); a non-integer id stays String and warnsSchemaDriftWarning. (#988) - HockeyTech: the PWHL and 19-league parsers,
<lg>_pbp, schedules, rosters, leaders and summaries emit everyid/*_idasInt64(player_idwas Float64 in pbp,team_id/game_idString or the caller's dtype). (#988) - KenPom: the jersey column is String on every page and renamed to
jersey:team/team_players_expandedplayer_table*column_0->jersey(was Float64) andboxtable_*column_0_rk->jersey(was Int64). A season of pages stacks without a String / Float64 clash, and no jersey reads"2.0". (#928) - NBA / WNBA / MBB / WBB pbp:
espn_<lg>_pbpkeepscoordinate.x/coordinate.ybut changes their meaning: they were ESPN's raw feet (hoop at (25, 0)) and are now the hoopR / wehoop full-court frame (x = y - 41.75,y = x - 25, both negated on home-team plays), always Float64. (#844) - NBA / WNBA / MBB / WBB pbp: ESPN's missing-location sentinel reads about +-2.1e8 after the transform; filter on
coordinate_x_raw > nba_game_page.COORD_SENTINEL. The release converters (helper_<lg>_play_by_play) rebuild from the raw pair, so a processed payload converts once. (#844) - NBA / WNBA / MBB / WBB pbp: ESPN's values move to the new
coordinate.x.raw/coordinate.y.raw(coordinate_x_raw/coordinate_y_rawsnake-cased); on the NBA / WNBA free throws hoopR / wehoop's "Free Throw" match finds, the raw pair holds the pinned (25, 13.75), as in the published files. (#844) - NFL processor:
NFLPlayProcess's*_player_idcolumns (String) andpos_team,lag_pos_team,lead_pos_team,lead_pos_team2,start.pos_team.id(Int32) areInt64, as in the CFB processor; a source whose ids are not integers (NFL.com gsis"00-0034796") keeps them String. (#981) - NFL, CFB: processed plays keep their documented Float64 for the EP/WP family,
first_down_prob,prob_2ptanddrive_start(they were Float32 when a model scored), with no value change, and NFLteamParticipantshas one struct field order;create_box_score(plays_frame)still reproducesadvBoxScoreexactly. (#797) - NFL:
sportsdataverse.nfl.model_vars.qbr_varsis in the QBR trainer's order (qbr_epa,pass_epa,rush_epa,sack_epa,pen_epa,spread), andnfl/models/qbr_model.ubjis re-saved with those feature names (same trees), so a frame in the old column order raises instead of scoring permuted inputs. (#795) - NFL: the season flips on the Wednesday after Labor Day and week 1 starts the Thursday after (nflreadr's rules;
week read one high in 2015-16, 2020-22, 2026-27).
most_recent_nfl_seasonandget_current_weekshare that rule, so from September 1 to that Wednesday they give the previous season (week 22), not the new one. (#791) - NHL API parsers:
parse_nhl_web_*,parse_nhl_records,parse_nhl_stats_rest,parse_nhl_edge_*andnhl_edge_skating_valueemit everyid/*_idasInt64(was Float64 / String by payload,player_ida Utf8 pin); stats-restformatted_season_idand the countryidare text and stay String. (#986) - NHL API parsers: pandas output carries the ids as nullable
Int64(wasfloat64/object); any other id that is not an integer keeps its column String and warnsSchemaDriftWarningnaming it, as the ESPN parsers do. (#986) - polars 2 required. The runtime pin is now
polars>=2.0,<3(conda recipe mirrored); polars 1.x is no longer supported, so code may use 2.x-only API such as thebin_*replacements forcut/qcut. The lock already resolved polars 2.0 on every supported Python, so nothing tested 1.x. (#776) - Producers, RDS:
pyreadr.write_rdscannot write pandas' nullableInt64with a missing value. For that write only, cast id columns to nullableInt32when every id fits in 32 bits (df[id_cols].astype("Int32"): R integer,NAkept), else tofloat64(R double); the parquet and the frame stay Int64. (#981) - Producers, RDS:
sportsdataverse._rds.write_rdswrites nullable Int64 as R integer, but only for a flat frame: it raisesValueErroron a nested column, which every ESPN schedule frame has (List(Struct)linescores, records, highlights). (#981) - Producers: before the first post-upgrade run, cast stored ids once (
pl.col(c).cast(pl.Int64)) or rebuild every season; otherwisepd.concat/to_parquetfails on a mixed column, andpl.concat(how="diagonal_relaxed")silently turns the ids back into String. (#981) - Producers: move stored and republished ids to
Int64now, not back to String, and rewrite the stored history in one pass so every season of a release carries the same integer ids. Update (or pin to a pre-release commit) every producer that writes these frames first, then upgrade to this release. (#981) - Producers: that covers the snapshot histories, the ESPN schedule season masters, and the PWHL schedule master and
per-game final JSON, whose seasons mix text (
"1") and integer (1) ids until the JSON is reprocessed. (#981) - PWHL:
pwhl_player_box(game_id)returns{"skaters": DataFrame, "goalies": DataFrame}, as fastRhockey'spwhl_player_boxdoes and as thefastRhockey-pwhl-rawproducer reads it. It used to return a single (always empty) DataFrame. (#851) - R packages: releases rebuilt from these parsers (the ESPN schedule seasons of the hoopR / wehoop raw repos, the PWHL schedule and pbp releases) carry integer ids that hoopR, wehoop and fastRhockey document as character in places; republish every season in the same pass and update the R documentation to match. (#981)
- Release loaders: Int32 ids (
team_idin those rosters,load_pwhl_rosters,load_pwhl_xg_pbp) join Int64 ones as they are. Code that relied on String ids can cast back withpl.col("team_id").cast(pl.String)(pandas:.astype("string")); anInt64id stringifies as"123", never"123.0". (#981) - Release loaders: String ids also remain in
load_{mbb,nba,wbb,wnba}_rosters(athlete_id,position_id,status_id) andload_{mbb,nba,wnba}_game_rosters(game_id); joining one to live parser output raisesSchemaError, so cast first:release.with_columns(pl.col("game_id").cast(pl.Int64)). (#981) - Release loaders: they keep their published dtypes, so String ids remain in
load_pwhl_schedules(game_id,home_team_id,away_team_id),load_pwhl_pbp(team_id,player_team_id,home_team_id,away_team_id,game_season_id) and the PWHL box scores'player_id. (#981) - Spring football EP/WP:
build_spring_football_pbp(..., league="cfl")andenrich_spring_football_pbp(..., league="cfl")raiseValueError; they scored CFL plays (110-yard field, three downs) with the NFL boosters, whose support isyardline_1001-99.get_sf_constants("cfl")still returns the CFL rule constants. (#1010) - stats.ncaa.org fetch layer: a real 404 raises
NoDataErrorafter one request; a banned or exhausted proxy pool, an uncleared bm-verify challenge or the Terms gate raisesAssetFetchErrornaming which. Both wereRuntimeError; catchAssetFetchErrorinstead (a missing proxy configuration is stillRuntimeError). (#920) - Errors: a failed fetch in generated flat-API wrappers (
espn_*,fox_api_*,cbs_*,mlb_api_*, NHL,asa_*) and other getters (mlb_statcast_*,torvik_*,kenpom_*,on3_*,yahoo_*,nfl_api_*, ...) raisesAssetFetchError(400 / 422:ValueError), never "no data". - ESPN (cross-league): the hand-written scrapers (
espn_<league>_schedule/_teams/_pbp,espn_*_player_stats,bref_*,build_nfl_players, ...) raiseAssetFetchErroron a failed fetch andValueErroron 400 / 422 instead of parsing the error body as data. - HockeyTech: season names read as their end year, so
season=can pick another season (WHL / KIJHLseason=2026is now 2025-26); one-year preseasons answer to the next year, exhibitions aregame_type="exhibition", the default is the newest regular season, andseason_yrisInt64. - HockeyTech:
hockeytech_api(PWHL and the 19 other leagues) raisesAssetFetchErroron a failed fetch or HTTP-200 error sentinel andNoDataErroron a 404 instead of returning an empty frame, as do season-defaulting wrappers whose seasons lookup fails. - MLB:
mlb_statcast_search/_search_minors/_search_wbcpin the 14 MLBAM id columns to nullableInt64:on_1b/on_2b/on_3bwere Float64 (660271.0), and pandas output fromparse_mlb_statcast_searchgives nullableInt64instead of numpyint64. - NBA / WNBA:
nba_stats_*/wnba_stats_*raiseAssetFetchErrorinstead of returning{}(404:NoDataError, 400 / 422:ValueError);nba_live_*/nba_l2m*/nba_referee_assignmentsnow raiseValueErroron 400 / 422;wnba_on_court/wnba_possessionsraise on a failed rotation fetch. - NBA / WNBA:
nba_stats_*/wnba_stats_*season arguments default to the latest season with rows and each league's own default ids, so endpoints that summed every season (drafthistory,leaguegamefinder,playergamestreakfinder, ...) return one season. - NFL: the 11 per-type loaders deprecated since 0.0.68 (
load_nfl_ngs_passing/_rushing/_receivingand eightload_nfl_pfr_*per-type and weekly variants) are removed, with theirsportsdataverse.parsed.nflaliases. - NFL: fantasy-football id columns are
Utf8(wereInt64):load_nfl_ff_playerids(mfl_id,fantasypros_id,pff_id,nfl_id, ...),load_nfl_ff_rankings(kind="draft")idandkind="week"fantasypros_id; zero-padded ids such as"0156"keep their padding. - Soccer / EuroLeague: the ASA, FIFA, FotMob, UEFA, MLS, NWSL and EuroLeague frames keep
nullable types: a nullable boolean is
Boolean(was a string with"nan"), a nullable integer isInt64(wasFloat64), and an all-null column isUtf8.
Upgrade notes —
-
Errors: catch
AssetFetchErrorwhere a loop must keep going;except NoDataErrorkeeps skipping absent resources;except SportsDataverseErrorcatches both, timeouts included; aValueErrormeans the call itself needs fixing.EmptyResponseWarningnow fires only for a 2xx with an empty object. Code that caughtrequests.HTTPErrorfromnfl_api_*or readexc.responsemust catch the new types (read the status from the message). HockeyTech wrappers that default the season raise when the seasons lookup fails; passseason_id=to skip it:import sportsdataverse as sdvfrom sportsdataverse.errors import AssetFetchError, NoDataErrortry:df = sdv.ahl_schedule()except NoDataError:df = None # the fetch worked and there is nothing there: skip itexcept AssetFetchError:raise # the fetch failed: retry later, never record it as empty -
HockeyTech seasons: a caller who passed the start year to get a season should pass the end year; preseasons answer to the next year (
resolve_season_id("ohl", season=2027, game_type="preseason")is the "2026 Pre-season"); passseason_id=where divisions listed side by side for one year are not told apart (e.g. BCHL 2024). -
nba_stats / wnba_stats: pass
seasonexplicitly for a lockout or pandemic calendar; for every season pass an empty one (season_year_nullable=""fordrafthistory,season_nullable=""forleaguegamefinder/playergamestreakfinder). -
NFL loaders: replace
load_nfl_ngs_passing,load_nfl_ngs_rushingandload_nfl_ngs_receivingwithload_nfl_nextgen_stats(seasons, stat_type=...), andload_nfl_pfr_pass,load_nfl_pfr_weekly_pass,load_nfl_pfr_rush,load_nfl_pfr_weekly_rush,load_nfl_pfr_rec,load_nfl_pfr_weekly_rec,load_nfl_pfr_defandload_nfl_pfr_weekly_defwithload_nfl_pfr_advstats(seasons, stat_type=..., summary_level=...). -
NFL fantasy ids: code that joined or compared these ids as integers should cast its own side to
pl.Utf8; callsportsdataverse.nfl.clear_cache()after upgrading, since cached frames keep their old dtypes (above all withcache_mode="filesystem").
Added
fox_nfl_pbp/fox_cfb_pbp: newplay_playercolumn, the player Fox credits the play to. (#922)- Basketball crosswalks:
_crosswalk_alt.with_alt_game_legs()/fill_game_legs()fill a schedule crosswalk's null Fox game and team ids (and a null Yahoo game id) from the parsed*-alt-datahistory; on the NBA crosswalks that is 1,260 of 1,379 games for 2002. The rest are preseason and All-Star games, which Fox does not list. (#825) - Basketball crosswalks:
genius_game_crosswalk,genius_team_crosswalk,ibba_segev_game_crosswalkandpleague_team_crosswalk(exported from the genius, ibba and plg homes) map provider ids onto the Genius, Segev and Preciser ids by shared keys, never by name. (#862) - Basketball crosswalks: the Fox and Yahoo legs are opt-in and fail-soft: any Fox or Yahoo failure logs a warning and leaves the columns null. (#793)
- Basketball: each minted function takes an END-year
season;comp=(FIBA),comp_id=(Genius) orseason_id=/competition_id=(Atrium) override it. (#862) - Basketball: nine more FIBA competition families, verified against the live GDAP API:
fiba_eurobasket_*,fiba_americup_*,fiba_asiacup_*,fiba_icup_*(Intercontinental Cup) andfiba_bcla_*(BCL Americas). (#864) - Basketball: per-competition functions minted from
tools/codegen/basketball_competitions.yaml:fiba_wc_*,fiba_oly_*,fiba_bcl_*and more (FIBA),wbbl_*,bal_*,lfb_*and more (Genius),lnb_*,nbl1_*,lpb_*and more (Atrium). (#862) - Basketball: the women's FIBA families
fiba_ecw_*(EuroCup Women),fiba_wamericup_*,fiba_wasiacup_*andfiba_wafrobasket_*. (#864) - CFB / NFL: on a slice of
plays_frame(Game on Paper's quarter and half boxes), a drive is valued at its first snap of the whole game, so a carried-over drive keeps its real start; a drive with no scrimmage snap is not averaged. Theespn_{cfb,nfl}_adv_drivesreleases pick it up on their next rebuild. (#836) - CFB / NFL: the
espn_{cfb,nfl}_adv_team(and CFBadv_team_gamelog) releases pick upyards_per_dropbackon their next rebuild. (#740) - CFB / NFL: the advanced box's
drivesrows carryavg_start_ep, the team's average drive start in expected points: each drive's first scrimmage snap valued on the league's bundled field-position curve (cfb_field_position_ep/nfl_field_position_ep). It is Game on Paper's Drives-table EP row, moved here. (#836) - CFB / NFL: the advanced box's team rows carry
yards_per_dropback, sack-inclusive yards per dropback ((pass_yards + sack_yards) / passes, over the same dropbacks asyards_per_pass, which still counts a sack as 0 yards). It is the basis of SDV'syardsdropbackpercentiles. (#740) - CFB / NFL: the advanced box's turnover rows carry
passes_defended, the opponent's ESPN box passes defended against the team's throws (CFB addsInt; ESPN's college PD excludes it), null where the box has none. (#737) - CFB CBS ids: the CBS scoreboard resolver reads FCS and postseason pages for the id map, a new
offline
_match_cbs_cardjoins a season's stored CBS cards to ESPN games (either home/away order, within three days), and the ESPN -> CBS team map gains five FCS schools (325 teams). (#815) - CFB crosswalks:
_crosswalk_alt.match_season(known_teams=)takes fixed ESPN -> provider team pairs for teams that share every game date (an FCS team with one FBS opponent, any team early in a season);known_teams("cbs", "cfb")serves the CBS resolver's map, so CBS CFB games match 99% of ESPN's schedule in most seasons. (#835) - CFB models:
fg_model/two_pt_model/xpass_modelcards record the rows actually fitted (42,617 / 1,628 / 1,902,481) instead of the training frame's height, andcfb_cp_model_air_yardsgains the card it shipped without. (#847) - CFB models: each booster ships
<model>.importance.json(gain / cover / split counts read off the booster bytools/cfb_model_importance.py). (#847) - CFB models: every bundled model card states its holdout status:
qbr_modelnames its disjoint holdout (2026 regular season, weeks 1-4),wp_ot_reachalready did, and the other nine sayin_sample: truewith the reason (fit on every season they score). No model bytes changed. (#847) - CFB play-by-play:
errors.PlayOrderWarning, warned when the processed plays step back a period (the row order or ESPN's period label is wrong there; 401628439 files an overtime touchdown as period 2). (#837) - CFB: an
overUnderAvailableplay column and payload key say whetheroverUnderis a market total or the 55.5 default (a line with a spread and no total).odds_overrideaccepts it (a missing key is unknown: a null flag), so a rebuild keeps it and warnsDefaultOddsWarningagain instead of relabelling the default as injected. (#895) - Cricket:
cricket_win_probabilityselects the ODI fielding-restriction regime from the match date (cricket_model_constants.ODI_REGIMES/cricket_regime: pre-2005, 2005 powerplays, 2011 window, 2012 two new balls, 2015+);cricket_match_statecarriesmatch_dateand the output gainsregime. (#743) - Cricket: a regime applies whole (its own resource grid and
REGIME_CONSTANTSpar/sigma), or falls back to the pooled 2002-2026 fit when its grid has fewer than 100 cells of 30+ states or it has no fitted constants (the 2011 window). (#743) - Crosswalk history harvest: private
sportsdataverse._crosswalk_historycaptures Fox, Yahoo and CBS raw game listings and per-game box payloads into the*-alt-rawrepos: resumable, atomic, season-checked, and paced byXWALK_RPS/XWALK_<PROVIDER>_RPSonly; a 403 or 429 stops the run. (#805) - Crosswalks: the private
sportsdataverse._crosswalk_altparses stored Fox / Yahoo / CBS payloads into per-seasongames/game_rostersparquet and matches them to ESPN: teams by (date, side), games by (US-Eastern date, team pair), players within each game and team, voted across the season. (#817) - Czech Extraliga: 9
elh_*wrappers insportsdataverse.hockey.elh(play-by-play, shots, events, scoreboard), pluselh_game_ids. (#826) - Dependencies:
pyyamljoins theallextra. (#752) - Docs: the CFB, NFL, NBA, WNBA, NHL and soccer tutorials each draw a chart with sdvplot: team-coloured win probability (CFB, NFL), a season shot chart on the court (NBA, WNBA), a rink shot map (NHL) and a pitch shot map (soccer). Without the plotting extras the cell prints a one-line install hint instead of a traceback. (#1021)
- Errors:
sportsdataverse.errors.SchemaDriftWarning. The NHL api-web / EDGE / Stats REST / Records, MLB Stats API, stats.nba.com and ESPN parsers still return zero rows for a payload shape they do not recognise, but warn naming the parser and payload path, so an upstream schema change no longer reads as "no data". (#907) - Errors:
warnings.filterwarnings("error", category=SchemaDriftWarning)turns schema drift into a failure. (#907) - ESPN Core v2 lists: every wrapper
parse_itemsparses (athletes_index,venues,season_athletes, ...) returns two Int64 page-envelope columns,count(items across every page) andpage_count, polars and pandas alike, so one page of several shows in the frame; null where the payload has no envelope (athlete_statisticslog). (#906) - ESPN international basketball wrappers: ESPN's
nblhas box scores but no play-by-play for 2025-26 (the NBL changed stats provider); the NBL Rosetta family fills that gap. (#849) - ESPN international basketball wrappers: ten more ESPN basketball leagues get the universal
espn_<prefix>_*family:nbl(Australian NBL),fiba(FIBA events),olympics_mbk/olympics_wbk, and the NBA Summer League sitesnbasl_lv,nbasl_ut,nbasl_ca,nbasl_sac,nbasl_orl,nbasl_gs. Every slug was checked live. (#849) - ESPN soccer:
parse_soccer_scoreboard(everyespn_<league>_scoreboard) carries the event'sseason_typeandseason_slug, and it and the summaryheaderframe carry a derivedtournament("apertura"/"clausura", null for single-tournament leagues), so Liga MX's two competitions per ESPN season id can be split. (#742) - eSports hokejovyzapis: 41 wrappers over the DEL (12), ICE Hockey League (12), EIHL (9) and
Metal Ligaen (8) feeds, in
sportsdataverse.hockey.{del_,icehl,eihl,metal}. (#826) - G League:
sportsdataverse.nbagl.nbagl_statswraps the 94 stats.nba.com endpoints live for the G League (LeagueID=20, sent by default), with returns tables built from real G League captures. Its default ids come from the capture sweep and have not been called live;shotchartlineupdetailrequiresgroup_id. (#1020) - Game pages:
sportsdataverse.nba.nba_game_pagescores WNBA, men's and women's college basketball game pages as well as the NBA's, chosen by aleagueargument ("nba", "wnba", "mbb", "wbb";league_id="00"/"10"still work), with the college in-game models and priors and the men's college period clock. (#848) - Game pages: new warehouse-path and fetch-pair helpers for the sdv-db stage and the Game on Paper processor. (#848)
- Game pages: regulation periods are read per game (the WNBA before 2006 and women's college before 2015-16 played halves, men's college always does); a neutral site gets no home-court advantage (prior source "neutral"); college free throws stay off the shot chart. (#848)
- Game pages: women's college turnovers follow their eras: 2009-12 from team turnovers, null before 2009 and for any game whose two teams together show fewer than 5 turnovers. (#848)
- Hockey:
khl_club_crosswalk(KHL club id <-> per-tournament team-season id, read from a covering set of game headers),khl_club_crosswalk_from_frames, andha_player_crosswalk(HockeyAllsvenskan player id == SHL isa id, plus the SHL athlete uuid). (#865) - Hockey:
sihf_standingscounts every game by default (venue="All"; unasked, SIHF answers the away-games table), and a table body with fewer rows than it announces raisesAssetFetchError. (#779) - Hockey:
sportsdataverse.hockey.sihfwraps the keyless Swiss Ice Hockey Federation statistics API (data.sihf.ch) for every SIHF league (National League, Swiss League, MyHockey League, amateur, junior and women's leagues), with elevensihf_*wrappers. (#779) - Hockey: per-game
sihf_pbp(goals, penalties, goaltender changes, revoked goals, shootout attempts),sihf_game_info,sihf_game_player_stats,sihf_game_goalie_stats,sihf_game_team_statsandsihf_game_lineups. (#779) - Hockey: season tables
sihf_results,sihf_standings,sihf_player_statsandsihf_goalie_statstake aphase_id;sihf_phaseslists a league and season's phases (ids differ by league, season and table) with names and game counts. (#779) - Hockey: SIHF answers an unknown season, league or phase with another one (
Season=1890gives the current season); the runtime compares the body's filter echo with the request and raisesNoDataErrorwhen they differ. (#779) - HockeyAllsvenskan: 11
ha_*wrappers insportsdataverse.hockey.ha(schedule, play-by-play, standings, skater/goalie/team stats, leaders, players). (#826) - International basketball: 530 wrappers over 24 providers (28 flat-API stems), each family in its own
sportsdataverse.basketball.<home>package with parsers and a throttled runtime. Payloads are fetched from public sources, not redistributed; each family's docstring notes carry its terms-of-use flag. (#859) - International basketball: providers are FIBA (
fiba_gdap,fiba_gamepage), Genius Sports, Sportradar Atrium, NBL Australia, FEB, BBL/DBBL (scb), Lega Basket, ACB, IBBA, KZS, LKL, ABA, BNXT (sportpress), Basketligaen (sportality), VTB, W League, KBL, B.LEAGUE, CBA, TBF, CEBL, TPBL, P. LEAGUE+ and EASL. (#859) - KHL: 23 wrappers in
sportsdataverse.hockey.khl: 14khl_*over the khl.ru REST and 9khl_webcaster_*over the webcaster API. (#826) - Ligue Magnus: 11
magnus_*wrappers insportsdataverse.hockey.magnus(competitions, schedule, standings, game sheet, play-by-play, lineups, shootout). (#826) - Liiga: 23
liiga_*wrappers insportsdataverse.hockey.liiga(schedule, box scores, shot map, standings, team and player stats). (#826) - MBB:
sportsdataverse.mbbnow exports (and the docs list) the NCAA league-RAPM helpers ofmbb_ncaa_rapm_input/mbb_ncaa_rapm_league(resolve_possessions,aggregate_stints,solve_rapm_league, ...) pluscurrent_ncaa_team_altsandsides_from_box; they were public module functions no page documented. (#987) - MLB:
load_mlb_schedule(seasons)reads themlb_schedulesrelease (statsapi schedule, every game type, 1988+). (#794) - MLB:
load_mlb_statcast(seasons)reads themlb_statcastrelease (Baseball Savant pitch-level data, one parquet per season, 2015+; spring training and exhibition pitches included). Theon_1b/on_2b/on_3brunner ids are published as floats and cast to Int64 at the loader boundary. (#794) - Model lineage: a new Model lineage docs page records the fitting script of every bundled booster (26
.ubjfiles) and fitted constant, which boosters are byte-identical to their release asset, and which cited fitting scripts are lost or untracked. (#984) - Model lineage: the NCAA RAPM ridge-lambda and NBA shot-talent shrinkage fitters move into
tools/(fit_ncaa_rapm_lambda.py,fit_nba_shot_shrinkage_k.py);TALENT_SHRINKAGE_K["10"](WNBA) is documented as a seeded placeholder, and the NFL prediction constants say their fitting scripts are lost. (#984) - National League: 17
nl_*wrappers insportsdataverse.hockey.nl(games, box scores, shots with xG, standings, player and team stats). (#826) - NBA / WNBA / MBB / WBB crosswalks:
{nba,wnba,mbb,wbb}_schedule_crosswalk(fox=True)fillsfox_game_id(and the NBA / WNBAfox_home_team_id/fox_away_team_id) from Fox's per-date scoreboard, matched on US-Eastern date and teams in either home/away order; a late tip ESPN files at 23:59 ET matches Fox's 00:00 ET a day apart. (#793) - NBA / WNBA crosswalks:
nba_crosswalks_from_archive()/wnba_crosswalks_from_archive()takealt_root=, an*-alt-datacheckout whose parsed Fox / Yahoo history fills the player crosswalk's nullfox_athlete_id/fox_player/yahoo_player_id/yahoo_player_nameoffline. (#817) - NBA / WNBA crosswalks:
nba_crosswalks_from_archive/wnba_crosswalks_from_archive(fox_games=True)fill the Fox game and team ids for any season Fox serves. (#793) - NBA / WNBA crosswalks:
nba_crosswalks_from_archive/wnba_crosswalks_from_archivetakefox=True:fox_team_idby team name for any season, and the Fox player columns for the current season only (Fox rosters are today's). A failed Fox fetch warns and leaves them null. (#786) - NBA / WNBA stats:
SDV_PY_NBA_STATS_PROXYroutes everynba_stats_*/wnba_stats_*call through a proxy (http://user:pass@host:port) when the call passes noproxy_url;proxy_url=""bypasses it. stats.nba.com and stats.wnba.com hang on cloud IPs, so thetutorials-refreshworkflow sets it from a proxy pool. (#1017) - NBA / WNBA:
league_idpicks NBA 48-minute or WNBA 40-minute regulation; only"00"and"10"are scored, and anything else raisesValueError. (#749) - NBA / WNBA:
nba_crosswalks_from_archive()/wnba_crosswalks_from_archive()build a past season's team, schedule and player crosswalks offline from the ESPN schedule and game-roster parquet plus the local stats box-score archive; the live builders only reach the current season. (#773) - NBA / WNBA:
sportsdataverse.nba.nba_game_pagescores a game page: per-play in-game win probability with deltas and an overtime regime, the pregame prior from the spread, court-frame shot coordinates, team four factors / ratings / pace and player TS% / usage. (#749) - NBA / WNBA: a null play score is carried forward before scoring, and
game_page_framesreturns the rate frames with their documented columns (zero rows) before both team box rows exist. (#749) - NBA / WNBA: team turnovers repair ESPN's duplicated pre-2013 team turnover and its null 2018
total_turnovers, and the win probability settles to 1.0 / 0.0 on the "End Game" / "End Period" row of a decided game from Q4 on. (#749) - NBA:
load_nba_stats_draft(seasons)reads thenba_stats_draftrelease;seasonsis the draft year. (#780) - NBA: loaders for the multi-file
nba_statsreleases:load_nba_stats_synergy,_hustle_player/_team,_matchups/_matchups_rollupand five_draft_combine_*tables. Each unions a season's files, stampsseason_type/per_modefrom the file name where rows lack them, and takes START-yearseasons. (#780) - NBA: the team and schedule crosswalks now compute
yahoo_team_id(nba.t.{espn id}) andyahoo_game_id(nba.g.{YYYYMMDD ET}{home id}) from 2014 on, where they were null. (#773) - NCAA:
scrape.ncaa.espn_player_xwalkmaps NCAA roster player ids to ESPN athlete ids per (season, ESPN team) for MBB, WBB and MFB, in four tiers that leave ties unmatched; the-rawrepos run it as stage 07. (#813) - NFL Fox ids:
sportsdataverse.nfl.fox_pbp.game_id._resolve_fox_game_idresolves Fox event ids, the Fox twin of the CBS week-scoreboard resolver (same arguments, light import), so a nightly id map can fillfox_event_id; the football id map's team table now carriesfox_team_id. (#804) - Packaging: new
sdvplotandsportypyextras (both also in[all]): sdvplot (>= 0.1.1, its first release that allows polars 2) for team logos, colors and chart themes, sportypy for drawing play-by-play and shot coordinates on rulebook fields, rinks and courts. sportypy is GPL-3.0 and optional. (#1017) - SHL: 27
shl_*wrappers insportsdataverse.hockey.shl, plusshl_ssgt_uuidandshl_player_crosswalk. (#826) - SIHF: 22 more
sihf_*table wrappers (team, skater and goalie goals, shots, special teams, penalties, shootouts, faceoffs, time on ice, attendance), 33 in the family. (#826) - Validation:
pbp_invariantschecks basketball clock seconds:end <= starton every*_seconds_remainingpair, andendequals the next play'sstartwithin a period. (#841) - Validation:
pbp_invariantsholds a period's last basketball play to the period's 0:00 (seconds.<scope>_period_last_row_ends_at_zero), so a producer that clampsendtomin(end, start)no longer passes. (#844) - VHL: 13
vhl_*wrappers insportsdataverse.hockey.vhl(schedule, game report, play-by-play, standings, skater/goalie stats, players, rosters), plusvhl_tn. (#826) - WBB NCAA:
ncaa_wbb_shot_locationstakesseason=, resolved throughwbb_period_model(halves through 2014-15, quarters from 2015-16); the default stays quarters, since stats.ncaa.org shot locations only exist from 2019. (#742) - WNBA / MBB / WBB crosswalks:
yahoo=Trueon the team and schedule crosswalks fillsyahoo_team_id(Yahoo's listing joined to ESPN by full name, short name, then nickname where school names agree; unmatched teams are logged). (#793) - WNBA / MBB / WBB crosswalks:
yahoo_game_id={lg}.g.{YYYYMMDD ET}{home Yahoo id}, checked against the ids Yahoo lists so a neutral-site game takes Yahoo's home side. (#793) - WNBA crosswalks:
wnba_crosswalks_from_archive(..., yahoo=True)fillsyahoo_team_*andyahoo_game_idfor a past season through the live builders' Yahoo code; a failed Yahoo fetch leaves the columns null with a warning. (#803) - Analytics:
rolling_windowscomputes event-count form windows with prev-season, season and career baselines, extended to stats.nba / stats.wnba shot events. (#590, #657) - Analytics:
metric_curvesfits rate curves along a continuous axis (shot distance, field position), binned on the coordinate distance rather than the nominal label. (#652, #658) - Analytics:
defense_vs_positionreports what each defense allowed to QB, RB, WR and TE, filtered by the season-type column. (#659, #660) - Basketball: KenPom, Her Hoop Stats, Basketball-Reference, RealGM and the salary, draft and
injury surfaces (#451), then Bart Torvik's
torvik_game_stats,torvik_player_statsand the publictorvik_game_schedule(#678). - CFB:
paper_indexports Game on Paper's Paper Index and season deserved wins. (#661) - CFB:
CFBPlayProcessfills missingyds_punted,yds_kickoffand bare-puntyds_punt_returnfrom ESPN field position, with newyds_punted_source,yds_kickoff_sourceandyds_punt_return_sourcecolumns ("text","derived"or null); parsed values never change. - CFB:
cfb_drive_summary.create_drive_summary()(StatBroadcast-style drive summary) andcfb_situational_stats.create_situational_stats()(per-team situational block), withCFBPlayProcessdelegates; graduated from Game on Paper. (#470) - ESPN (cross-league): the ESPN CDN family (
cdn.espn.com/core) as generatedespn_<league>_cdn_*wrappers, with a per-endpoint league allowlist from a live probe. (#681) - EuroLeague: 8 new wrappers:
euroleague_game_points()(shot chart),euroleague_game_pbp(),euroleague_game_boxscore(),euroleague_game_header(),euroleague_standings(kind=),euroleague_player_stats(),euroleague_team_stats()andeuroleague_game_report(). - F1:
sportsdataverse.f1wraps the keyless Jolpica (Ergast-compatible) API:f1_schedule,f1_race,f1_results,f1_qualifying,f1_sprint,f1_pitstops, standings, drivers, constructors, circuits and the pagedf1_laps(season, round); data is CC BY-NC-SA 4.0. - Fox:
fox_api_*wrapsapi.foxsports.comdirectly (33 endpoints), beside the per-leaguefox_<league>_*Bifrost wrappers. (#680) - G League: ESPN's G League is a documented league: the universal family (112 wrappers:
espn_nbagl_standings,espn_nbagl_scoreboard,espn_nbagl_summary, ...) is exported fromsportsdataverse.nbagland the top-level package. (#684) - MLB:
load_mlb_park_dimensions()loads one row per MLB venue per season from 2001: fence distances, capacity, turf, roof, elevation and coordinates, withvenue_idas a string. - NBA:
sportsdataverse.nba.nba_officiatingreads official.nba.com:nba_l2m(game_id),nba_l2m_games(season),nba_referee_assignments(date, league=),wnba_referee_assignments();nba_live_pbp()/nba_live_boxscore()and WNBA twins read the cdn liveData feeds. (#592) - NFL: NFL Pro Next Gen Stats: the
pro.nfl.comfamily (nfl_pro_*, 16 endpoints) andload_nfl_ngs(seasons, dataset=)over the SDV-nativenfl_ngs_*releases (12 datasets). (#454, #481, #489) - NFL:
sportsdataverse.nfl.shield_pbpgraduates thenative_pbpparser and adds its live layer (phase, provisional rows, current situation) and theshield_nfl_pbpentry point. (#528, #536) - NFL:
load_nfl_fp_curve()loads the bundled NFL field-position EP curve (2016-2025 fit), andfit_nfl_field_position_ep(pbp)refits it. - NFL / CFB:
NFLPlayProcess/CFBPlayProcessacceptsource=and build the same frame from Shield (#540), Yahoo (#541, #543), CBS (#542, #545), NCAA (#544) and Fox (#548) feeds throughsportsdataverse.football.sources; the dispatch table landed in #525. - NFL / CFB:
football.tendencies(team and coach splits) andfootball.usage_box(usage, situational and special-teams box), with EPA and game-context cuts, read back by 28 loaders such asload_{cfb,nfl}_team_tendenciesandload_{cfb,nfl}_usage_players. (#496, #497, #498, #614) - NFL / CFB:
espn_nfl_pbp(summary=)/espn_cfb_pbp(summary=)process a stored ESPN summary with no network, andNFLPlayProcess(odds_override=)mirrors the CFB contract. (#491) - PFF: the official Developer API: 68
pff_api_*wrappers (sportsdataverse.nfl.pff_api), keyed byapi_key=,PFF_API_KEYorSDV_PY_PFF_API_KEY;strict=True/SDV_PY_PFF_STRICT=1raises on withheld columns. The cookie-authpff_*premium wrappers still work, marked LEGACY. - Providers: 46 wrappers in six new families:
espn_content_*,thesportsdb_*($THESPORTSDB_API_KEY),football_data_*(Football-Data.co.uk),openligadb_*, and the read-only prediction marketspolymarket_*andkalshi_*undersportsdataverse.odds. - Providers: six documented provider APIs, each generated from its own endpoint YAML: CBS NAPI
(
cbs_napi_*), Yahoo Shangrila (yahoo_shangrila_*), Fox, ASA (asa_*), MLS (mls_api_*) and NWSL (nwsl_api_*). (#452) - Reference data: 36 loaders over the
{league}_groupstags for nine leagues:load_<league>_groups(),load_<league>_group_seasons(),load_<league>_group_aliases()andload_<league>_team_group_seasons(seasons); NCAA baseball isload_ncaa_baseball_*. - Registry:
sportsdataverse.registry(metrics.yaml) defines each published football metric once;resolve(column)maps a column to its entry, andpython -m sportsdataverse.registry --ts --target gop|webrenders a TypeScript module. (#645) - sdv-docs:
sdv-docs, a stdio MCP server over a published docs index with six read-only tools (search,get_function,find_columns,find_endpoints,list_datasets,index_info); installsportsdataverse[mcp](Python 3.10+);SDV_DOCS_DB=<file>uses a local index. - Soccer:
XThreatfits an Expected Threat grid andsoccer_xthreat_rate(actions)addsxt_value;load_xthreat_model()loads a bundled 12 x 16 grid fit on StatsBomb open data (research / non-commercial use only). - Soccer:
soccer_spadl(dataset)converts any kloppy event dataset into SPADL actions (a socceraction port);soccer_open_dataset()returns the dataset behindsoccer_open_events(). - Soccer:
asa_players_xpass(league_slug, season_name=...)and thenaslanduslsASA leagues; USL Super League takes split-year labels (season_name="2024-25", not2024). - Soccer: the optional
soccerextra (pip install "sportsdataverse[soccer]", kloppy) addssoccer_open_events("statsbomb", 8658)for open event data andsoccer_events_to_frame(dataset)for any kloppy dataset. - Validation:
sportsdataverse.validationgainsvalidate_game+GameReport, the advBoxScore reconciliation rules, NCAA source column aliases and the football processor invariant sweeps. (#553, #554, #555, #556, #558, #510)
Changed
download(): a 403 from api.nfl.com, premium.pff.com, comp.uefa.com, kenpom.com or herhoopstats.com is not retried; a malformed URL (MissingSchema,InvalidURL,InvalidHeader) raises at once instead of retrying ~50 s. (#880)download(): retry waits share a 180 s budget per call and a wait over 10 s logs a WARNING; a 2xx error envelope or JSON scalar is never written to the response cache. (#880)- Basketball / hockey runtimes: in the 34 international basketball and European hockey getters a route's own data
request's 204 / 205 returns
{}(wasNoDataError/AssetFetchError), and a 204 on a lookup (token, session, key page, season list, game or scope check) or mid-way through a multi-request answer isAssetFetchError. (#929) - Basketball runtimes: a 400 is
ValueErrorin EASL, KBL, KZS and VTB Infobasket, and IBBA's blank 200 isAssetFetchError. (#929) - CFB crosswalks:
load_cfb_teams_crosswalk/load_cfb_schedule_crosswalkaccept 2013. Thecfb_crosswalkrelease now carries 2013 (Yahoo and Fox legs), which the old 2014 floor hid. (#790) - CFB play-by-play: the kickoff touchback and out-of-bounds spots (2012 kickoff rule) come from one
catalogued table,
sportsdataverse.cfb.model_vars.TOUCHBACK_YARDLINE_BY_SEASON(+cfb_touchback_yardline_expr). A refactor: no output value changes. (#829) - CFB validation: the box-score parity harness grades penalties (accepted fouls, committing team), fumbles lost (offense and defense) and net passing (total minus rushing) the way ESPN counts them, and adds a player-level check and a per-game integrity screen. (#764)
- CFB: the team summaries, percentiles, passing, receiving and advanced-box column descriptions match the republished definitions: run-stuff and opportunity rates over rushes, per-drive drive metrics, passer success over dropbacks, per-target receiving rates null for 2021-2024. (#741)
- Codegen: an endpoint YAML can name a
body_builder:(a runtime callable) that turns the flat body into the nested JSON an API wants; only top-levelNonefields are dropped, so a builder handlesNoneinside what it nests. (#864) - Codegen: endpoint YAML can declare path/query transforms (
transform: {offset: -1},{fn: ..., with: [...]}), a per-routegetter:, typedchoices:(int / date, checked typed by the wrapper) and a familyno_r_fallback:flag. (#865) - Codegen: flat-API endpoints take
body: query|form|jsonand per-paramin: query|body; CBA, KHL REST and HockeyAllsvenskan use it, with a curl example in the docs. A callerparams=entry that names a body field overrides the body; any otherparams=entry goes to the query string. (#862) - Dependencies:
urllib3 >= 2.8.0is a direct runtime floor (three open advisories below it) and thetests/allextras needcurl_cffi >= 0.15.0(redirect SSRF).recipe/meta.yamlis re-mirrored frompyproject.toml(scikit-learn,urllib3,tomliwere missing);tools/check_recipe_mirror.pydiffs the two. (#751) - Docs: a parser's "empty payload gives a zero-row frame" note moves to its Returns, and the parameter table of a
POST body endpoint (
body: form|json: CBA, KHL, HockeyAllsvenskan) gains an In column (path/query/body). (#864) - Docs: admonitions render again, every hand-written page has a search description, and version stamps, stale counts, dead parser links and unused template images are gone. (#1021)
- Docs: league pages are titled with the registry label ("NBA Summer League (Las Vegas)", "Men's college basketball") instead of the raw prefix, and the Getting Started sources table runs sport by sport with a Sport column and each ESPN-only league's API breakdown. (#1021)
- Docs: pages that mostly list per-competition functions minted from the competition registry no longer call them "hand-written wrappers", and a split family page never ends on a lone function. (#864)
- Docs: reference and "Additional functions" pages render a Raises table from the function's docstring, one
row per exception and never a
Nonerow; generated wrappers (includingnba_stats/wnba_stats) list their runtime's error vocabulary plus any endpoint YAMLraises:qualifier. (#864) - Docs: returns tables show polars dtypes (
String,Int64,Float64,Boolean) instead of R type names; reference rows whose summary was onlyGET /pathread as the endpoint's name ("Box score advanced v3."), in the wrapper docstrings too. (#1021) - Docs: the home page leads with the
pip install --preline, a code example, leagues grouped by sport and registry group, and a data-sources strip; a small bar announces the 0.2.0 beta. (#1021) - Docs: the MBB, WBB, G League, AHL, ECHL, OHL, QMJHL, USHL, WHL, college hockey, college baseball and softball, UFL, XFL, FIBA and cricket pages list sdvplot (and sportypy where it draws the surface) as companions, and every sdvplot / sdvplotR link points at its docs site. (#1021)
- Empty results keep their columns: the ESPN league wrappers of 45 dedicated parsers and the soccer / cricket
scoreboards, generated and multi-file NBA stats loaders, 3 HockeyTech parsers and
enrich_pbpreturn their table, not (0, 0);parse_items,parse_single_entityand cdn rankings still return (0, 0). (#978) - ESPN player stats / Fox: a stat with no
valuetakes a plain-numberdisplayValue("0") and is otherwise null (NHL "0:00"); the column is always Float64. Foxframe()warns when a column mixes text and numbers. (#979) - ESPN schedules:
espn_cfb_scheduleandespn_mlb_schedulereturn an empty frame with the documented columns on a day with no games; they returnedNone. (#855) - ESPN schedules: the seven scoreboard-backed
espn_<lg>_scheduleemit their documented columns in documented order on every day (a column the day left empty is a typed null, not absent); columns ESPN adds later follow. A documented integer column no longer arrives as Float64 when one event lacks it (tournament_id). (#855) - ESPN wrappers: a collection as a path value raises
ValueError, and a float id is sent as its integer ("13", not"13.0"). (#896) - ESPN wrappers: a keyword the wrapper does not take raises
TypeErrornaming the wrapper, before any request. (#896) - ESPN:
parse_team_rosteron a position-grouped roster returns zero rows with aSchemaDriftWarningwhen any group or player is not an object; it returned the other groups' rows. (#941) - ESPN: the 12 generated site-v2 wrappers whose name a hand-written function held are now public as
espn_<lg>_calendar_site(cfb, nfl, mlb, nba, wnba, mbb, wbb) andespn_{wbb,wnba}_{standings,team_roster}_site/espn_wnba_draft_site. The package names still run the hand-written functions; other leagues keep theirs. (#903) - ESPN: the scoreboard
broadcastcolumn keeps every network name, ", "-joined in feed order and deduplicated ("ESPNU, ESPN+"); it kept only the first name of each broadcast entry. (#865) - Game pages:
nba_game_page.game_page_framesreads the game's neutral site, so a lineless neutral-site NBA game (the All-Star Game, Rising Stars) starts from a 0.5 prior (prior source "neutral") instead of home-court advantage; its win probabilities move by up to 0.08 for existing NBA callers. (#848) - Generated wrappers: a
bool_strflag (ESPNactive=, Foxinclude_answers=, MLSis_live=) raisesValueErrorfor any string other thantrue/false/1/0;"yes"was sent as"true"and""as"false". (#896) - HTTP chokepoints: a 2xx
{"code": 400-599, "message"}envelope is classified by its code (404NoDataError, 400/422ValueError, elseAssetFetchError); barttorvik and the Savant CSV leaderboards refuse an HTML page asAssetFetchError; Yahoo and On3 data routes refuse a JSON array where an object belongs. (#880) - HTTP chokepoints: a 2xx JSON
null, number, string or boolean body raisesAssetFetchErrorinstead of reaching a parser as data (or{}), except OpenLigaDB's/getlastchangedate, which answers a bare ISO string by design. (#880) - HTTP:
dl_utils.downloadPOSTs when givendata=/json_body=and never caches a body request, so_codegen_runtime._getsends form and JSON bodies and a body endpoint needs no runtime getter of its own. (#864) - HTTP: a POST through
downloadis retried like a GET, so it is for idempotent read APIs only. (#864) - KHL:
khl_player_statsdocuments goaliesv_pctas a 0-100 percentage (92.2 = .922),gaaas goals against per 60 minutes andtoias total "minutes:seconds" text. (#868) - MBB/WBB:
ncaa_espn_team_crosswalk(league=)reads the{mbb,wbb}_crosswalksportsdataverse-data release (built weekly by sdv-reference-data), so a new season no longer waits for an sdv-py release; it warns and falls back to the bundled CSV when the release cannot be read. (#770) - MBB:
load_mbb_player_crosswalk()documentskp_player_id, the KenPom player id hoopR-mbb-data now publishes afteryahoo_player_name(18 columns), andkp_game_idonload_mbb_schedule_crosswalk()is described as filled. The livembb_player_crosswalk()builder stays at 17 columns. (#787) - MLB:
fit_zone_modelexcludes 2026+ pitches with aUserWarning(Savant reports them against the ABS zone and the calls are challengeable), andmlb_umpire_called_strike_prob/mlb_umpire_bias/mlb_catcher_framingcarry anabs_eraflag, with per-umpire and per-catcher rows split by era. (#743) - NFL fourth-down getters:
get_go_wp,get_fg_wp,get_punt_wp,get_2pt_wp,get_2pt_probsandget_4th_down_probstreat onlyFileNotFoundErroras a missing model; a corrupt cached booster (XGBoostError) or a disagreeing model card (ValueError) propagates instead of yielding NaN. (#899) - NFL loaders:
[]returned every season fromload_nfl_schedule,load_nfl_nextgen_stats, season-levelload_nfl_pfr_advstatsandload_nfl_espn_qbr, and raised fromload_nfl_ratings_weekly/load_nfl_ngs; a mistyped season (2024.5,Truein a list,"2024x") now raisesValueErrornamingseasons. (#898) - NFL loaders:
load_nfl_player_stats(True), an old positional call for the removed kicking flag, loads every season of the non-kicking stats where it raisedTypeError; passkicking=Truefor kicking stats.load_nfl_player_stats(False)still raisesTypeError. (#898) - NFL loaders:
load_nfl_rostersandload_nfl_depth_chartstake the current season on the roster calendar (the year turns on March 15), as nflreadpy does;load_nfl_nextgen_statsraisesSeasonNotFoundErrorbefore 2016. (#898) - NFL loaders:
seasons=NoneraisedTypeErrorin the helper-backed loaders, and inload_nfl_player_stats(its default) loaded every season since 1999. (#898) - NFL loaders:
seasonsfollows nflreadpy:Noneloads the current season,Trueevery season from the loader's first to the current one (skipping a current season not yet published), and[]an empty frame without a request. (#898) - NFL models:
enrich_nfl_pbp(strict=True)orSDV_PY_MODELS_STRICT=1raisesFileNotFoundErrornaming a missing model instead of nulling xYAC, xpass or fourth-down columns; the ESPNNFLPlayProcesspath honours the variable. (#899) - NFL models:
enrich_nfl_pbpandNFLPlayProcessstill catch such an error and skip the step with aRuntimeWarningunless strict mode is on. (#899) - NFL models: when the download-on-demand nfl4th models (
fd_model.ubj,wp_model.ubj) cannot be obtained, the fourth-down step warns once per artifact; it returned all-nullgo_wp/fg_wp/punt_wpsilently. (#899) - NFL Pro:
NFLProAuthErroris anAssetFetchError(still aRuntimeError); pro.nfl.com's empty-200 rejection, a GraphQLerrorsenvelope or a body withoutdata.viewer.gameDetailraises instead of giving an empty pbp. (#918) - NFL:
nfl_pro_*, theapi.nfl.comtoken mint,nfl_game_schedule/nfl_game_details/nfl_game_pbpandnfl_ngs_*raiseNoDataError(404),ValueError(400/422) orAssetFetchError(429/5xx after retries, a dead connection, an empty/HTML/scalar 2xx) instead ofHTTPError/KeyError/JSONDecodeError/ValueError. (#918) - NFL: NGS retries 408/429/5xx but not its 403 deny, the schedule / details GETs retry, the getters honour
SDV_PY_HTTP_TIMEOUT, a string pro.nfl.comlimitpages correctly, and an undecodable token is logged. (#918) - NHL Records:
nhl_records_comeback_wins(scope=)raisesValueErrorfor anything but"league"or"franchise";"Franchise"or"team"returned the league-wide table. (#928) - On3: the deprecated
on3_*_rankingsshims raiseValueErroron a malformedyear/sport_slug(was{}). (#921) - Packaging: the
sdvplotextra now installssdvplot[mpl], sopip install --pre "sportsdataverse[sdvplot]"brings matplotlib and draws charts without a separate install. Courts, rinks and pitches still need the GPL-3.0sportypyextra. (#1021) - Possession cache:
nba_season_compile.PIPELINE_VERSIONis 5, so per-game caches keyed by it (compile_nba_season, and WNBA builders that import_game_cache_key) recompile once. (#818) - Provider flags and numbers take their documented types: CBS / Yahoo flags are Boolean (never "nan" / "True"),
Odds API
outcome_pointis Float64 where markets exist, EuroLeague headerroundis Int64, college baseball pandas integers stayInt64, and the On3 rankings tables document their integer columns as integer. (#979) - PWHL:
pwhl_team_ratingsforwards topwhl_ratings_from_proxy(itsleagueargument is ignored);nhl_player_propstakesload_skater_boxscores=andteam_ratings=, and the NHL impact engines takexg_scored=, so another league binds its own data and xG model. (#846) - Runtimes: The Odds API raises
AssetFetchErroron a dead connection (wasConnectionError) or a scalar 2xx body; LEGACYpff_*raisesAssetFetchErroron a JSON array (was{});pff_*and the 247Sports getters honourSDV_PY_HTTP_TIMEOUT. (#921) - Season loaders (generated, and
load_nfl_team_group_seasons): a fractional season ([2024.5], which loaded 2024) raisesValueError, as does a bool season;seasons=NoneraisesValueErrorwhere it raisedTypeError. (#896) - Spring football:
enrich_spring_football_pbpthreads the league-seasontouchback_yardlineandep_point_valuesfromget_sf_constantsintoenrich_nfl_pbp(new keyword-onlyleague=,touchback_yardline=,ep_point_values=; NFL defaults unchanged), so XFL / UFL kickoffs are scored from their own touchback spot. (#744) - Statcast search: every chunk takes its returns table's dtypes;
zone,release_spin_rate,spin_axisand the*_days_*columns are Int64 on all three routes, and an empty window has those dtypes instead ofNull. (#979) - Tests: warnings are errors. A test asserts an expected warning with
pytest.warns(..., match=...)or filters an incidental one by exact message; live tests skip on a timeout or upstream 429/5xx, the live job runs on Ubuntu, and thetestsextra needs pytest >= 8.0. (#726) - WNBA / NBA loaders:
load_wnba_stats_shotsandload_wnba_stats_player_game_logsaccept 1997 onward, andload_nba_player_crosswalkandload_wnba_player_crosswalk2002 onward, the seasons their releases publish; the old 2026 / 2025 floors hid them. (#848) - CFB: the bundled xQBR model (
cfb/models/qbr_model.ubj) is retrained on the served box score without the spread (qbr_varsis the five EPA aggregates plusera0..era3), behind a publish gate; everyexp_qbrchanges. - CFB: the vendor special-teams name regexes moved into
sportsdataverse.football.espn_text(CLAUSE_NAME,CLAUSE_RETURNER_RE,CLAUSE_FG_KICKER_RE); output is unchanged. - CFB:
cfb_returning_productionmeasures defense from play participants (2014+) or pbp splash plays (2004-13) and weights it intooverall_returning(offense 0.49 / defense 0.51), sooverall_returningvalues change; newdef_basisandoverall_basiscolumns. - Docs:
generate.py --checkfails when a public callable has noReturns:/Yields:section; reference pages show a returns table captured from real data, or say why there is none. - Docs: blank returns-table descriptions are filled only from the league's own sport's R packages, never with R argument text; NFL Pro, On3 and 13 Fox Sports tables gain authored descriptions.
- Docs: league index pages can list companion packages in a "See also" block
(
tools/codegen/companions.yaml); the SOCCER page links kloppy, sdvplot, sdvplotR, itscalledsoccer, soccerdata and mplsoccer. - Docs: the docs site is generated from one league registry: table rows leave the search index,
plain function headings, large reference pages split by family, a
main (latest)label and a codegen-rendered changelog. (#664, #671, #672, #673, #674, #676) - Models: native thread pools default to one:
SDV_XGB_THREADS(default 1) stops xgboost's predict from fanning across every core per request; raise it deliberately. (#563) - NFL / CFB: the situation-neutral split in
football.tendenciesreadswp_before_naive(score, clock and field position) instead ofwp_before, so every*_neutralcolumn andsec_per_play_neutralmove. - NFL / CFB:
tackle_sharecounts only the defense's own scrimmage snaps, with newscrimmage_tackle_pointsandteam_scrimmage_tackle_pointscolumns;tackles,assistsandtackle_pointsstill count every credit. - Packaging: polars 2.x is allowed (
polars>=1.0,<3, mirrored inrecipe/meta.yaml); the lock resolves polars 2.0.0 on Python 3.10+ and 1.36.1 on Python 3.9. - Validation:
tools/validation/source_parity, a nightly harness, compiles the same games from two providers and reports column-level disagreement. (#547)
Deprecated
- Config: 29 unread
sportsdataverse.configrelease URLs warnDeprecationWarningand are removed in 0.4.0; use the generatedload_<league>_*loaders. They areCFB_{ROSTER,TEAM_SCHEDULE,TEAM_INFO}_URL,NFL_PLAYER_STATS_URL,NFL_PLAYER_KICKING_STATS_URLand{NHL,PHF,MBB,NBA,WBB,WNBA}_{BASE,PLAYER_BOX,TEAM_BOX,TEAM_SCHEDULE}_URL. (#987) - Config: the warning fires on
from sportsdataverse.config import NBA_BASE_URLand onimportlib.import_module("sportsdataverse.config").sdv.configissportsdataverse.nfl.config(bound bysportsdataverse.nfl's star import), sosdv.config.NBA_BASE_URLraisesAttributeErrorwith no warning. (#987) - ESPN teams:
espn_<lg>_teams.cache_clear()(the eight leagues) is a no-op that warnsDeprecationWarningand is removed in 0.4.0. The functions no longer cache, so there is nothing to clear. (#888) - ESPN: the old names of those 12 wrappers in
*_espn_ext(from sportsdataverse.cfb.cfb_espn_ext import espn_cfb_calendar, ...) still return the wrapper but warnDeprecationWarningnaming the*_sitename; they are removed in 0.4.0. (#903) - MBB / WBB:
sportsdataverse.scrape.ncaa.league_config(NcaaLeagueConfig,MBB,WBB,by_league) warnsDeprecationWarningon access and is removed in 0.4.0. Nothing read it, andWBB.periods = 4is wrong before 2015-16; pass the league slug and usescrape.ncaa.parse.wbb_period_model(season). (#853) - NBA / WNBA:
load_nba_stats_{pbp,possessions,lineups}_v3and the fourload_wnba_stats_*shims (lineups,player_season_stats,standings,team_season_stats) now say they are removed in 0.4.0; they named 0.1.0, which has shipped. A test fails if a removal version falls behind again. (#726) - Package layout: the ESPN side leagues (
nbl,fiba,olympics_*,nbasl_*) andeuroleaguemoved undersportsdataverse.basketball, the cross-sport sources undersportsdataverse.providers, and four helpers undersportsdataverse.analytics. Old paths, deep ones included, alias the new modules until 0.4.0, warning. (#1020) - PWHL:
pwhl_team_ratings(league=...)is deprecated and ignored (the ratings are always PWHL); passing it warnsDeprecationWarning; removed in 0.4.0. (#846) - Utilities:
sportsdataverse.dl_utils.ESPNHTTP/ESPNResponse, the polarsdf.janitor.to_pascal_case()/to_camel_case()/to_kebab_case()methods andsportsdataverse.decorators.record_mem_usage/record_time_usagehad no caller; they still work, warnDeprecationWarning, and are removed in 0.4.0. (#987)
Removed
- Dependencies:
matplotlib,pyjanitor,inflectionandattrsare no longer runtime dependencies (nothing imported them;tests/test_import_sweep.pyimports every module with them blocked).black,flake8,isort,pyclnandpydocstyleleave thetests/allextras; themodelsextra is empty (already base deps). (#752) - Internals: the private
sportsdataverse._common_espnmodule (host constants plus a_get/_csvre-export nothing read) leaves the package and the wheel; import_getfromsportsdataverse._codegen_runtime. The committedtools/codegen/_generated/staging copies and the retiredextract*.pybootstraps are deleted. (#985) - MBB / WBB: the NCAA <-> ESPN team-crosswalk builder
tools/crosswalk/is gone; sdv-reference-data (sdv_reference/crosswalks/) builds and publishes the{mbb,wbb}_crosswalkasset thatncaa_espn_team_crosswalk()reads first (#770). The bundled fallback copies stay. (#788) - Python 3.9 dropped.
requires-pythonis now>=3.10(3.9 is end-of-life and HEAD no longer imported on it:cfb/cfb_drive_summary.pyevaluatesset[int] | str | Noneat def time). The lock now resolves polars 2.0 on every supported Python;scrape/ncaa/canary.pyimports on 3.10. (#748)
Fixed
*_pbp_disk/CFBPlayProcess.cfb_pbp_disk/NFLPlayProcess.nfl_pbp_disk: saved ESPN payloads are read as UTF-8. On Windows they were decoded with the platform default (cp1252), which garbled every non-ASCII player and team name in an offline rebuild. (#996)download(): a call made without aloggerno longer adds anotherNullHandlerto thesdv.dl_utilslogger each time; the module adds its one handler at import. (#992)espn_injuries_snapshot/espn_depthcharts_snapshotwarn and keep the other leagues / teams when one fetch fails; one failure discarded the whole day, which cannot be re-taken. Every fetch failing still raises. (#924)fox_nfl_pbp/fox_cfb_pbp: rows come back oldest-first on a live game too (Fox serves newest-first until FINAL). (#922)ncaa_mbb_date_games/ncaa_wbb_date_games: they close the browser they open; a lingering one made the next browser fetch in the process fail. (#920)scrape.espn.persist.write_payloadwrites through a temp file andos.replace, so a crash mid-write no longer leaves a truncated.jsonthat counts as captured and is never re-fetched; ESPN's{code, message}error body is refused like the other error shapes. (#924)- Archive crosswalks: the team pairing (date and home/away co-occurrence) leaves a team unpaired when two candidates tie, instead of taking the lower id. A full season never ties; a slice of a few dates could pair the wrong franchises. (#817)
- Atrium game wrappers: a game the site does not serve (an unknown fixture id, or another site's game) raises
NoDataErrorinstead of an echoAssetFetchError, and the minted Atrium game functions no longer refuse a game whose season the site's (incomplete) season list omits. (#864) - Basketball courts:
get_court(league_id, season=)returns the three-point geometry in force that season (the NBA 22-ft arc of 1994-97, the WNBA 19'9" / 20'6.25" / FIBA eras). (#738) - Basketball game pages:
game_page_framesno longer raises when ESPN'sformatis not an object (a string, or aregulationthat is not one); the game's regulation falls back to the league's season era. (#900) - Basketball: the minted per-competition game functions refuse a game of another competition with
AssetFetchError, and needseasonorcomp(their docs say so). The parameterisedgenius_*/fiba_gamepage_*/atrium_*wrappers are otherwise unchanged. (#864) - Basketball: the per-process listing cache keeps at most 1,024 entries (least recently used evicted), so a backfill does not grow it without bound. (#864)
- Basketligaen (
sportality): five returns-table descriptions (ppg,3_p_perc,blkpg,ec,ft_perc) are no longer cut mid-parenthesis, and thestandings_standingstest samples keep their wholedataColumnsheader. (#892) - BBL / DBBL (
scb):tv_channelonscb_games_recentandscb_gamejoins the channel names ("DYN,Sport Bild Stream") instead of writing Python dict text; null entries and null names are skipped, never written as"None". (#892) - Caches:
clear_cache()(both) deletes only the entries the cache wrote, never other files in the cache directory, and a corrupt NFL cache entry that cannot be unlinked no longer escapes asPermissionError. (#899) - Caches: a memory-cache hit (NFL loaders and the HTTP response cache) returns a copy, so editing a returned frame or payload in place no longer changes what the next call gets. (#899)
- CBA numbers: about 100 display-string columns (
'21.6'averages,'39.4%'percentages) across the season lists, team tables, advanced box and shot zones are Float64. A percent string is a fraction 0-1, socba_player_offensive.turnovers_rate('13.5%') is 0.135, whilecba_team_four's numeric 13.5 stays 0-100. (#864) - CBA numbers: thousands commas are dropped (
'1,234'),'12.0'in an integer column is 12,'nan'/'inf'are null;seasonand the schedule win/loss counts are Int64, jersey numbers and code-table values stay text, and columns null in every capture take the family's dtype. (#864) - CBA: a POST route called without
json=raisesTypeError; the generated wrappers always send it, so their behaviour is unchanged. (#864) - CBA: without
CBA_PROXYa request from a datacenter fails in seconds (5 s connect timeout, no retry of a refused or timed-out connect) instead of after about three minutes; read timeouts, mid-response resets and proxied failures are still retried. SetCBA_DIRECT=1where direct access works for the full timeout and retries. (#864) - CBS football adapter: a failed (non-404) optional NAPI resource raises instead of reading as absent, and the NFL adapter does not fetch CBS's odds when the caller already supplies the line. (#922)
- CBS football adapter: a failed scoreboard page (a dead connection, a 403/5xx after retries) is read again after 5 minutes instead of being remembered as "no games" for the life of the process. (#922)
- CBS NAPI: an unknown id (HTTP 200 with a
warningsentry of code 404) raisesNoDataError; it parsed to a zero-row frame. (#919) - CFB / NFL fumble attribution: a recovery-less fumble behind ESPN's degenerate end block that kept the ball
(non-scoring,
change_of_pos_teamFalse) is no longer lost: CFB 401856674165 (EPA unchanged); NFL is unchanged except 2810260184707, a 2008 fumble out of the end zone for a safety, correctly no longer a lost fumble. (#911) - CFB / NFL: the advanced box's
expected_turnoverstakes its pass term from ESPN's box passes defended, not from "broken up by" text whose coverage swings by season (2025 CFB weeks 1-8 vs 9-15: 0.68 vs 1.45 before, 1.26 vs 1.46 now); text stays the fallback where the box has no PD. (#737) - CFB
advBoxScorerow order:team/situational/defensive/driveslist the home team first, and the usage and special-teams sections (CFB and NFL) sort by their keys, so a game serialises to the same box in every process; before, these rows reshuffled from run to run. Values are unchanged. (#910) - CFB crosswalks:
cfb_schedule_crosswalkbuilds the same rows from the same upstream data. A Yahoo week that answered HTTP 200 with a cut-off JSON body was skipped, so its Yahoo ids and Yahoo-only games came and went between nightly builds. (#812) - CFB crosswalks: a full-season build raises
CrosswalkSourceErroron any failed ESPN calendar, ESPN week or Yahoo week instead of skipping it. (#812) - CFB pbp:
fumble_lost/fumble_recoveredread the recovering team from the text: a punt returner recovering his own fumble is no loss, and a muffed punt the kicking team recovers is one. (#778) - CFB pbp:
td_playfollows a touchdown type that 2014+ scoring-summary text never spells out ("12 Yd Interception Return (X Kick)"). (#777) - CFB pbp: kickoff touchbacks come out to the 25 from 2012 (they switched only after 2013, in
yds_kickoff_returnand the EP touchback yardline), andyds_fumble_returnreads the 2004-06 "returned for a N yard touchdown". (#778) - CFB pbp: pre-2014 onside recoveries (
Kickoff Return (Defense)) are typedKickoffbefore the kickoff possession flip, so they carrykickoff_play/kickoff_onsideand the right kicking / receiving team. (#777) - CFB play-by-play:
lag_halfandgame_play_numberfollow the final row order (15 captures moved); a play filed under an id outside the feed's numbering is placed by its period and clock (401425418's third-quarter kickoff was the game's first row). (#837) - CFB play-by-play: a
drive.*column no drive of a game carries (noendblock in 2005-09 games, nostart.clockorteamin a few others) is an all-null column of its documented String / Int64 type, notNull; everydrive.*field is typed from the returns table. (#980) - CFB play-by-play: a feed whose plays all lack the
endblock or the scores processes instead of raisingColumnNotFoundError(NFL too, forstart,end,clockand the scores); a pickcenter with no spread on any provider takes the no-pickcenter path instead of raisingIndexError. (#837) - CFB play-by-play: a fumble recovered by a team written mixed-case ("recovered by AlbSt") or in parentheses ("recovered by Omar Jacobs (BGSU)") is charged to the right team; 2014-20 team fumbles lost now match ESPN's box in 97-98% of team-games, from 86-90%. (#767)
- CFB play-by-play: a fumble's recovering team (and so
is_turnover,fumble_lost, EPA/WPA) comes from the recoverer's box-score team; ESPN'srecovered by <TEAM>token can name the wrong side and is now the fallback. 2024-26 recoverer team matches the box in 100% of sampled recoveries, from 90-95%. (#1015) - CFB play-by-play: a missing pregame total is 55.5 on every odds path (the pickcenter path used 55.0) and warns
errors.DefaultOddsWarning; ESPN's literal play text "null" is no longer a player name. (#837) - CFB play-by-play: kneel-downs ("Kneel down by TEAM ... (team loss of 2)", "takes a knee") and rushes no yardage reader matched (2004-13 "rush up the middle for 21 yards", yardless vendor rows) carry rushing yards; 2025 team rushing yards match ESPN's box in 64% of team-games, from 46%. (#768)
- CFB play-by-play: pre-2014 extra-point rows ("Extra point by Dave Rayner (MSU) is good.", "Felipe
Macias extra point GOOD.") set
xp_attempt,xp_madeandxp_kicker_player_name; all 46,762 had none. (#771) - CFB play-by-play: pre-2014 penalties ("HAWAII penalty 15 yard personal foul accepted") are charged to the team named in the text; 2006-13 team penalties match ESPN's box in 72-83% of team-games, from 21-25%. (#769)
- CFB play-by-play: regex-fallback player names no longer carry the clause they ran into ("Tommylee Lewistackled b", "Logan Hall, clock:32", a spot read as a fumbler); garbled names fall below 0.3% in every role and era, from up to 21%. (#772)
- CFB:
cfb_rosters_crosswalk(providers=(..., "yahoo"))fillsyahoo_athlete_idfrom Yahoo's team roster, matched by name + jersey, then by a unique name; it read the ~200-player stat-leaders feed and found 0-2 per team. New optionalyahoo_team_idskips the Yahoo team lookup. (#762) - CFB:
CFBPlayProcess(odds_override=...)readshomeFavoriteandgameSpreadAvailablestrictly, asoverUnderAvailablealready was:"False"/"0"are False (bool("False")read them as True), and a value that is not True/False, 1/0 or"true"/"false"/"1"/"0", None included, raisesValueError. (#946) - CFB:
CFBPlayProcess.cfb_pbp_disk()documents that an offline rebuild needsjoin_participants=Falseandodds_override. (#852) - CFB:
CFBPlayProcesslogs through its ownsdv.cfb_pbplogger; its root-modulelogging.debugcalls ranlogging.basicConfig()and installed a stderr handler on the host application's root logger. (#895) - CFB:
firstHalfKickoffTeamIdis the opening kicker andpos_team_receives_2H_kickoffis true only on its first-half possessions; it was inverted on every first-half row of home-kicked games, and set after halftime. (#781) - CFB:
fox_cfb_play_processreads Fox's absoluteyardStartthroughfox_common's geometry, so away-offense snaps are no longer mirrored (EP/EPA/WPA); an uncovered game raisesNoDataError, the backup makes no ESPN request, and the source contract rejects an adapted summary with a mirrored field. (#783) - CFB:
get_go_wpreturns NaN for a 4th-down row with noyards_to_goalordistance, instead of a garbage go-for-it value from casting NaN to an integer; other plays are unchanged. (#726) - CFB:
parse_cfb_ncaa_scoring_summaryreadsteamfrom the "Has Ball" logo's alt text; it was null on every scoring row of every stats.ncaa.org football box score. (#789) - CFB:
yds_rushed(and the line-yards split) is read from rush texts that left it null: "for 1 yard", "rush for loss of N", "Banyard rush" (matched "Yard Rush"), "1 Yd Run (... Run for Two-Point Conversion)", and directional gains on fumbled or flagged rushes. (#854) - CFB: a defensive Timeout row's
pos_teamis the offense, as nflfastR'sposteam, so itswp_beforeadds the offense's margin to the offense's EP; its EPA stays 0. (#905) - CFB: a fumble play the offense kept (
change_of_pos_teamFalse) whose ESPN end block sits at yardLine 0 / yardsToEndzone 0 no longer scores as a goal-line turnover: its end state is the next snap's start (one 2025 Q4 own recovery moves from EPA -5.91 to -0.41; 20 rows in 18 games of 2024-2026 move). (#834) - CFB: a game with no pregame spread (
gameSpreadAvailableFalse, rebuilds included) warns the newerrors.DefaultOddsWarning. (#828) - CFB: a half-ending play keys
wp_afteron the next real play's team (cfbfastR's rule), not its own possession change: a play that kept the ball when the other team snaps next now takes 1 - that play'swp_before. (#966) - CFB: a play ESPN files twice under two ids is booked once when the id sort strands one copy outside its drive (401420836's 11:58 rush and 10:44 punt now match ESPN's box score); a clock half its period shares is never compared. Across the 23,024 cfb-raw games: 489 fewer rows in 235 games, each removed row's twin kept (#925)
- CFB: a play ESPN files under an out-of-scheme id (a 10-digit
<game_id>0among 18-digit ids) goes right after the last play that precedes it by period, clock and, on a clock tie, ESPN's feed order, instead of after a count of such plays; a post-touchdown personal foul now follows its touchdown. (#908) - CFB: a rush, pass, sack or penalty whose ESPN end block is
{down 0, yardLine 0, yardsToEndzone 0}takes the next snap's down, distance and spot when the same team snaps next in the period (a 4th-down play short of the line to gain stays a turnover on downs); EPA moves on those rows, e.g. -1.85 -> -0.95 on a 2nd & 5 incompletion. (#905) - CFB: a shootout try ESPN files after a touchdown still counts inside the shootout: shootout win probability, no kick recommendation. (#792)
- CFB: a Timeout row (filed under the team that called it) is no longer a change of possession: the next play reads
the last real play's possession and score, and a play's
wp_afterthe next real board. (#834) - CFB: an overtime try is a two-point shootout attempt only under its season's rule set
(
model_vars.OT_SHOOTOUT_FROM_PERIOD: none before 2019, from the fifth overtime in 2019-20, the third from 2021). (#792) - CFB: an untyped overtime shootout attempt ("Sam Howell Two-Point Rush Attempt Failed") is a missed attempt, not a scrimmage snap. (#890)
- CFB: every attempt of a shootout period that does not open tied on ESPN's scores has null
wp_before/wp_afterinstead of a value read off them; the game-ending attempt keeps the result. (#890) - CFB: mostly first-half endings move (max |change| 0.161), in
wp_after,wpa,def/home/away_wp_afterand their_naivetwins. (#966) - CFB: only nulls change and EPA/WP do not move; a rush whose text names no carry stays null. (#854)
- CFB: overtime win probability values the forced two-point try after a touchdown (the third
overtime on before 2021, the second from 2021;
cfb_wp_overtime.OT_TWO_POINT_FORCED_FROM) instead of a kicked extra point in every period;get_2pt_probsrecommends the try there withxp_wpnull. (#743) - CFB: penalty rows after a defensive timeout lose a phantom
EP_between, so their EPA moves by up to 6.2 points;firstD_by_*flags and WP columns move with it, andlead_wp_before2skips timeouts to the second real row. (#834) - CFB: scoring zero rows (QBR on a live game's opening drive,
predict_from_cardon an empty frame) no longer logs XGBoost's "Empty dataset" warning. (#726) - CFB: the fourth-down (go, punt, field goal) and two-point decision surfaces put a post-score kickoff at the season's touchback spot, 80 to go through 2011 and 75 from 2012; they used 75 for every season. 2012+ values are unchanged. (#842)
- CFB: the mirrored-end repair reads across a Timeout or End Period row to the next real snap when that snap starts
where the play's
statYardageends it (a Q3-closing rush to the 1: EPA -4.62 -> 0.46). (#905) - CFB: the payload's
pickcenterodds are plain numbers (they were one-element arrays) and includehomeFavorite, so they feed straight back intoCFBPlayProcess(odds_override=...); values and play columns are unchanged. (#828) - CFB: the WP boosters learned that flag as
1 - is_homeand are still fed that (the_as_trained_2h_flagshim), so published WP is unchanged (each game's first row aside) until the boosters are retrained; no model bytes changed. (#781) - CLI:
sdvprintssdv: <msg>and exits 2 on aNoDataError/AssetFetchErrorinstead of a traceback. (#899) - Codegen: each
generate.py --checkgate renders into its own temp dir, so two concurrent checks no longer delete each other's files. (#761) - Cricket:
cricket_match_statereads a DLS-reduced innings' revised over allocation from the score string instead of the format's full ball budget. (#738) - Crosswalks:
{mbb,wbb,nba,wnba}_player_crosswalk(season=)for a past season reads that season's ESPN player box scores; ESPN's team-roster endpoint ignores?season=, so past seasons shipped the current roster under their own label (MBB 2025, WBB 2014-2025). (#782) - Crosswalks: the
_crosswalk_altCBS parse skips a box score whoseplayerStatsis a list: CBS answers a few college football game ids with a basketball box (CFB 2017 and 2021), which used to stop the whole season's parse. (#833) - discover:
function_count()andlist_functions()cover all 105 documented leagues (they skipped 60), from a table codegen writes from the league registry, and count thenba_stats/wnba_stats/nbagl_statswrappers with their league. (#1021) - Docs build: reference-page front matter quotes a
titleorsidebar_labelonly when plain YAML would misread it, so the ABA and TBF pages (labels with a colon and a space) build again; tests now check every page's front matter and every_category_.json. The scbx-api-secretnote no longer claims to mirror the site's code. (#861) - Docs:
espn_<lg>_calendarin seven leagues, and the wbb/wnbastandings/team_roster/draft, are documented as the hand-written functions those names run, not as the generated wrappers they shadow. (#901) - Docs:
nba_live_boxscore/wnba_live_boxscoredocument their six returned frames, one table each, and thenba_stats/wnba_statswrappers list theNoDataError/ValueError/AssetFetchErrorthey raise. (#901) - Docs: a function counts as documented only by its own reference block, not by a mention in a table or note, so 19
public functions (
load_pbp,atrium_end_year,shot_value, ...) and two classes now have entries. (#901) - Docs: a reST literal that starts with an underscore (
``_request``,``_PBP_COLS``) no longer loses its backtick on the generated pages. (#862) - Docs: Examples and page titles name each league's home module (
sportsdataverse.soccer.mls), not its deprecated alias; the NFL Pro page has a title, andparse_summarygives the right section count. (#901) - Docs: reference pages no longer cite private repositories, working notes, plan task ids or Scala
line numbers;
generate.py --checknow fails on such text in anydocs/docspage. (#1021) - Docs: tutorial install lines use
pip install --prefor the 0.2.0 beta and name thesportypyextra where a court, rink or pitch is drawn; the international basketball tutorial no longer says thesdvplotextra brings sportypy, and the NFL tutorial skips its NFL Pro cell without credentials instead of printing the auth error. (#1021) - Docs: tutorial pages print a skipped call as one short line (no repeated
NoDataError: NoDataError:, no HTML error page) and carry a real meta description, the opening paragraph of their notebook. (#1021) - Errors: a 404 message reads
No data found for <url>, notNoDataError: No data found ..., so a printedNoDataErrorno longer shows its class name twice. (#1021) - ESPN calendars:
espn_mbb_calendar/espn_wbb_calendaracceptseason=None(current season) and a float2024.0. (#855) - ESPN game rosters:
espn_mlb_game_rostersreturns a zero-row frame with its columns when ESPN lists no competitor roster; it returnedNone. (#878) - ESPN game rosters: an athlete
$refanswering 404 drops that athlete with aUserWarninginstead of failing the game; a single team logo is kept aslogo_href, and an unreadable logo shape warns instead of writing"". (#878) - ESPN game rosters: the seven Core v2
espn_<lg>_game_rosters(mbb, wbb, nba, wnba, nfl, nhl, cfb) keepposition_id(integer),position_name,position_display_name,position_abbreviationandposition_leaf(football and hockey alsoposition_parent_href), as hoopR and wehoop do. (#878) - ESPN parsers:
parse_athlete_statsreads the Web v3 per-season rows (it returned an empty frame for every athlete);parse_event_competitor_statisticsreads Core v2'ssplitsobject andparse_draftthe season-draft index (both raisedAttributeErroron every real call). Their returns tables are documented from real captures. (#889) - ESPN parsers:
parse_itemswarns when ESPN answered one page of several (espn_nba_athletes_index()returns 100 of 610 athletes by default). (#880) - ESPN parsers: the 30
_common_espn_parsersparsers that raisedAttributeErroron a non-dict body, or turned ESPN's 200 error envelope into a one-row frame, return zero rows. (#880) - ESPN rankings:
espn_{cfb,mbb,wbb,mch,wch}_rankings()returned zero rows (the Site v2 polls sit in a top-levelrankingslist, not Core v2items). A dedicatedparse_rankingsgives one row per ranked or vote-receiving team per poll. (#732) - ESPN rankings: columns are
poll_id,season,season_type,week(within the season type),rank(null on vote-receiving rows),previous_rank,points,first_place_votesand the team fields;team_idis a string. (#732) - ESPN rankings: the college baseball and softball wrappers use it too, but ESPN answers their rankings URL with a 404. (#732)
- ESPN schedules:
espn_mbb_schedule(dates=2024)returns the whole 2023-24 season, November through the title game, sorted by date (one request per game day); it returned Jan 1-13 2024 only. A failed day, or one that fills itslimit, raisesAssetFetchError. (#855) - ESPN schedules: all eight
espn_<lg>_schedulereturn a zero-row frame with the documented columns on an empty slate; one malformed event no longer discards the day;Canceledgames get null linescores likePostponed; NFL*_current_rankis a null integer (was the CFB default 99); parsing the same payload twice no longer raises. (#855) - ESPN soccer/cricket: the 68 wrappers that parse through
parse_soccer_*/parse_cricket_*now document those parsers and their returns tables (the 12 headline soccer leagues showed the generic tables), and every ESPN wrapper is annotatedUnion[pl.DataFrame, pd.DataFrame, Dict]instead ofDict. (#858) - ESPN soccer:
parse_soccer_summary(everyespn_<league>_summary) warnsUserWarning, naming the event id, when a payload has a match header but emptykey_events,commentaryandlineups, instead of returning zero-row frames silently; ESPN lists usa.nwsl 2014-2018 but ships no detail for those seasons. (#742) - ESPN soccer: summaries null the
(0.0, 0.0)"no location" coordinate pairs and strip trailing spaces from names. (#738) - ESPN teams: a payload without
sports[0].leagues[0].teamsreturns a zero-row frame with the documented columns instead of raisingTypeError/IndexError, and the docstrings no longer name aclear_cache()that never existed. (#888) - ESPN teams: the eight
espn_<lg>_teams(mbb, wbb, nba, wnba, nfl, nhl, cfb, mlb) drop their process-lifetimefunctools.lru_cache, which raisedTypeErroronheaders={...}, shared one frame object across callers and never expired. Each call returns its own frame;sportsdataverse.cacheis the opt-in TTL cache. (#888) - ESPN:
espn_<league>_leaders()returns one row per athlete with every stat as{category}_{stat}(Float64) and asort_order; it flattened ESPN's envelope into one row. Footballcategory=takesoffense:passing(a barepassingis an HTTP 400), and a league with no leaderboard gives zero rows. (#1018) - ESPN:
espn_<lg>_player_statsraisesAssetFetchErrorwhen the athlete or team dereference fails (403, 429, 5xx, a dead connection) instead of returning a row with null identity columns; only a 404 leaves those columns null. (#907) - FIBA game wrappers: a FIBA game page asked under a
compthat does not list the game raisesAssetFetchError(wrong scope) when GDAP knows the game, andNoDataErrorwhen it does not. (#864) - FIBA: a
comp=override must be an edition of the bound family; a competition GDAP gives no family is refused with that reason. (#864) - Fox / CBS / Yahoo / Shield / NCAA adapters: an id-map row with float ids adapts like one with text ids
(
"401671775", not"401671775.0"); a None / NaN /pd.NAid counts as missing. (#928) - Fox CFB / college basketball: a failed Fox CFP group fetch in
fox_cfb_schedule(season)is retried once, then warns (a 404 means "no CFP group");fox_{mbb,wbb}_teams_allwarn whenmax_callsruns out while the last fetch was still finding teams. (#922) - Fox football adapter: a punt, kickoff or missed field goal with no next snap (end of a half or of regulation, or the newest row of a live poll) ends with the receiving team at 1st & 10 (the kicking team if it recovers a muff). (#922)
- Fox football adapter: an event-less "No Play" penalty (a club-charged Delay of Game) is typed Penalty (8) and starts at the flag's spot, not End Period with the next snap's; a sack for a safety is a Safety scored by the defence. (#922)
- Fox football adapter: the last regulation snap of an overtime game no longer takes the OT kickoff's spot as its
end state, and a live poll no longer marks both clubs
winner. (#922) - Fox: an empty standings (or polls, events, nav, header, search, trending, roster) table parses to a zero-row frame instead of rows from another list in the body. (#901)
- Generated loaders and wrappers:
seasons=np.int64(2024)andseasons=2024.0load the 2024 season (they raisedTypeError), and a fractional year raisesValueErrorinstead of loading the truncated one.bool_str("false")is"false"; ESPN path params are URL-quoted; a misspelled ESPN wrapper kwarg names the wrapper. (#896) - Generated wrappers:
typing.get_type_hints()resolves every generated ESPN and flat-API wrapper (it raisedNameErroronpl), and wrappers that return a dict of frames (espn_*_summary, the CDN game payloads, multi-result-setnba_statsendpoints) are annotatedDict[str, pl.DataFrame], as their docstrings say. (#891) - Genius hosted pages: the HTTP 500 "A website error has occurred" page is reported as an intermittent Genius
host-side failure marked
transient(retry later), not as "the org has no plain hosted site"; the same WBBL, SLB, BAL, NZNBL and ESAKE schedule URLs answered it and then a full schedule. (#870) - Genius:
esake_pbpand the rest read the game's LiveStats/u/shell (one cached request per game) and check its competition name; when that request fails twice or the shell names none, the call raisesAssetFetchErrorsaying the scope check could not run, rather than returning the game unchecked. (#864) - Genius:
lfb_schedule(season=2019)(andgenius_scheduleof any page with an unfilled play-off slot) passes its scope check: aTo be determinedblock takes the competition the page's other blocks prove, and a page of only such blocks raisesAssetFetchError.lfb_*covers the two seasons Genius hosts, 2018 and 2019. (#864) - Genius: HTML pages served without a declared charset are read as UTF-8, so accented competition and team names
(French, Greek) no longer come out garbled (
requestsassumed ISO-8859-1). (#864) - Helpers:
find_athleteraisesAssetFetchErrorwhen a roster fetch fails (403, rate limit, 5xx) instead of reporting "no such player", skipping only a 404 roster;find_athlete/find_eventraiseValueError(notKeyError) for an unknown league. (#899) - Her Hoop Stats:
herhoopstats_team_rosteranswers a zero-row frame with the roster columns when the page has no roster; it returned the page's tallest table. (#919) - Hockey:
sihf_phasesgives a nullphase_namewhen a phase's name is missing, blank or not a string, like the other SIHF parsers; it gave""for a missing or blank name and the stringified value ("['x']") for a list or object. (#827) - Hockey: a
{"data": null}body parses to a zero-row frame (it was one all-null row) in the generic KHL webcaster, Liiga and National League parsers;khl_playoff_bracket.game_idsisList(Int64)(it was a comma-joined string). (#865) - Hockey: the European hockey throttle now leaves at least 1 s from the END of one response to the start of the next request to the same host, with one request in flight per host (it spaced request starts, so a 0.8 s answer let the next request go 0.2 s later). Every transport path records the finish, error answers and exceptions included. (#865)
- HockeyTech (PWHL and the 19 league families): a call with no
seasonreadsmodulekit/seasonsonce to pick and resolve the newest regular season; it fetched the feed twice under the 0.4 s rate limit. (#992) - HockeyTech:
<league>_schedule(season=...)(the 19 league families andpwhl_schedule) returns that season's games; it readmodulekit/scorebar, which ignoresseason_idand stops at 10,000 rows oldest-first, soahl_schedule(season=2026)returned AHL games from 1995-2012 and PWHL every season's. (#727) - HockeyTech:
<lg>_game_corsi/pwhl_game_corsiwithout a game summary (MJHL, whosegc/gamesummaryis denied) return zero rows instead of crediting every shot to the away skaters; a blank""home_team_idis skipped too. (#988, #989) - HockeyTech:
add_coord_transforms(every<league>_pbpandpwhl_pbp) put home-team events off the rink: it mirrored centre-origin feet with a 0-200 x 0-85 flip, andy_coord_fixedapplied the y transform twice. The derived columns are now rotations of the feet frame; the feed's home team attacks toward x = 0 in every period. (#735) - HockeyTech:
game_statusreads the schedule view's strings:Final OTwhere scorebar saidFinal 1st OT, and the start time (7:00 pm EST) for an unplayed game. (#727) - HockeyTech:
ot_period_lengthcarries the regular-season OT length for PWHL (300), ECHL and USHL (420) and BCHL (600). (#738) - HockeyTech:
parse_game_summaryadds itsgamestub row only with agame_idor data. (#923) - HockeyTech:
shot_distance,shot_angle,scoring_chanceand the xG features of those empty-net goals change. (#735) - HockeyTech:
x_coord_fixed/y_coord_fixed= (-x, -y), home team shooting right;x_coord_right/y_coord_right= home (-x, -y), visitor (x, y);x_coord_vertical/y_coord_vertical= (-y_right, x_right). (#735) - HockeyTech: a season's playoffs and preseason are separate HockeyTech season ids, so pass
season_idfor them; an empty reply, or a season filter that keeps nothing, is zero rows with the 12 columns. (#727) - HockeyTech: an empty-net goal (
empty_net"1") is measured to the net its team attacks, so a goal from the team's own half is the long shot it is; every other event still measures to the nearer net (89 - |x|), which is right for own-half events with a goalie in net, whose coordinates the feed mirrors. (#735) - HockeyTech: the 0.4 s request spacing holds when several threads call
hockeytech_apiat once; they could all read one stale timestamp and fire together. (#924) - HockeyTech: the client unwraps a JSONP body that ends in
);. (#851) - HockeyTech: the right and vertical columns are null when an event's side is unknown (no team, as on faceoffs, or
a null or empty home team id) instead of defaulting to the visitor's.
shot_distance,shot_angleand xG are unchanged; the published PWHL play-by-play keeps the old values until it is rebuilt. (#735) - HockeyTech: the schedules read
modulekit/schedule&season_id=<id>, which the feed scopes to one season, andparse_schedule(..., season_id=)drops any row from another season. (#727) - HockeyTech: with neither
seasonnorseason_id, a schedule is the newest regular season, as in the other season-aware functions; it used to be the feed's whole window. (#727) - HTTP:
_download_json(and the Yahoo Shangrila getter) re-fetches a truncated JSON body up to twice. (#812) - International basketball dtypes: a column name has one dtype across a family's tables:
fiba_gamepage_box_teams.blocks_receivedis Int64 (was String), andutc_offsetis Float64 on every GDAP table (a half-hour zone such as India +5.5 is a fraction). (#864) - International basketball dtypes: VTB Infobasket
plus_minus/player_position/height/weight, the KZS matchseasonand the TBF team-boxefficiencyare Int64; SCBshirt_numberis always String (a00jersey survives); Sportality per-game averages (blkpg,orpg,plus_minus_pg) are Float64. (#864) - KBL: the docs say an earlier (pre-2006-07) game's shot chart is a zero-row frame, as the code
returns, not
NoDataError. (#892) - KenPom / Her Hoop Stats: a failed login request raises the package's error vocabulary
(
AssetFetchError/NoDataError/ValueError) instead of a barerequestserror. (#919) - KenPom / Her Hoop Stats: a member page answered with the login form or Her Hoop Stats' free-tier
teaser (expired, replaced or unsubscribed session) raises
AssetFetchErrorand drops the cached session. (#919) - KenPom:
parse_kenpom_page()keeps a jersey"00"(team and box pages):read_htmltyped the jersey column, so"00"became 0. Any other zero-padded text column also stays text. (#928) - KHL:
khl_player_stats(position="goalies")declares the goalie columns (w,l,sop,ga,sv,sv_pct,gaa,so,toi), fetches every page and sorts by games played, wins, then name (page 1 used to be the goalies without a game). A partial page set raisesAssetFetchError. (#865) - KHL: a khl.ru answer that is ServicePipe's anti-bot JS-challenge page now raises
AssetFetchErrornaming the block (retry later or from another network) instead of "answered HTTP 200 without a sessid". (#866) - Lega Basket: the play-by-play
sideis documented as what it is, the basket the court zone is measured from (0 = x 0, 1 = x 100), not the home/visitor team (that isteam_side). (#864) - MBB / WBB:
ncaa_mbb_box_scores(..., errors="skip")(and the WBB twin) records aparse_failedstatus row for a game whose page parses to zero player rows (a page of another type); the game used to vanish from the season with no row. (#1014) - MBB / WBB:
ncaa_mbb_play_by_play/ncaa_wbb_play_by_playfetch a page the format guard rejects once and warn once; they re-fetched it as an empty scrape, a second stats.ncaa.org request and a second warning. (#887) - MBB / WBB:
ncaa_mbb_play_by_play/ncaa_wbb_play_by_playraise anUnsupportedPageFormatWarningthe caller escalated to an error; they swallowed it, re-fetched the page and returned 0 rows. (#853) - MBB / WBB:
parse_ncaa_bb_game_pbpon a 2018-format page andparse_ncaa_bb_team_scheduleon the older team page (2016) return the zero-row frame with anerrors.UnsupportedPageFormatWarningnaming the format; they returned 0 rows silently, or crashed / mis-paired half the games. (#853) - MBB / WBB: the bigballR-port parsers (
parse_ncaa_bb_box,_team_schedule,_team_roster,_game_pbp,_shots) return a zero-row frame for a non-HTML payload, andparse_ncaa_bb_boxfor another stats.ncaa.org page type, instead of raising. (#789) - MBB / WBB: the stats.ncaa.org pbp / shots / box drivers turn a float contest id into
"6470186", nevercontests/6470186.0/; box-score failures are logged, not printed; one owner for the WBB period model. (#853) - MLB docs:
pitcherin theload_mlb_xera,load_mlb_stuff_plus,load_mlb_command_plus,mlb_statcast_search(+_minors/_wbc),as_of_splitandbip_trajectory_featuresreturns tables reads "MLBAM player id of the pitcher", not "Whether the position is a pitcher". (#799) - MLB docs: on
espn_mlb_schedule,home_score/away_scoreare described as the ESPN scoreboard score rather than a per-play run total. (#799) - MLB docs: on the Statcast-search,
as_of_splitandbip_trajectory_featurespages,home_score/away_scoreare the score before the pitch andplayer_namefollowsplayer_type(the batter by default). (#799) - MLB Stats API:
mlb_api_extrasends a set, numpy array or floatleague_id/sport_idsthrough the shared_csv("103,104","103"); a set went out as"{103, 104}". (#928) - MLB umpire zone / catcher framing: a 2026-only pitch frame is fit on its own pitches; the 2026 guard dropped them all, so every pitch scored 0.5 and framing became a called-strike rate. A degenerate zone fit now warns. (#909)
- MLB:
espn_mlb_game_rosters(raw=True)keeps its per-entry rows, now withgame_position_id, andathlete_idthere is the entry'splayerId(it was null). (#1002, #1010) - MLB:
espn_mlb_game_rostersreads each rostered athlete from its Core v2$ref, soathlete_id,athlete_full_name,athlete_jerseyand the threeathlete_position_*columns (the listed season position) are filled; all six were null on every real game. (#1002, #1010) - MLB:
mlb_statcast_searchclamps a window before 2008-03-25 to the tracking floor with a warning, andget_baselineswarns when it falls back to the nearest committed season. (#738) - MLB:
pitch_featuresstandardizes velocity, spin, movement and release within pitcher AND season (game_year, else the year ofgame_date), so PITCHf/x speeds (2008-16) and Statcast out-of-hand speeds (2017+, about +0.5-1 mph) never share one mean. (#743) - MLB: an entry with no readable athlete is left out with a warning; when entries exist but no athlete can be read,
the game raises
NoDataError. No entries at all is the zero-row frame; a failed fetch raisesAssetFetchError. (#1002, #1010) - MLB: the new
game_position_id(Int64) is the position the player was entered at in this game. The athlete id is the entry'splayerId, else the id in its athlete$ref; an inline athlete record is used as is. (#1002, #1010) - NBA / WNBA / MBB / WBB pbp:
home_score/away_scoreare rebuilt from the scoring plays when that reproduces the official final (late-keyed plays, 2013-19 free throws, neutral-site side swaps); newscore_source("rebuilt"/"espn") says which (#830). (#830) - NBA / WNBA / MBB / WBB pbp: a period's first play ends where the next play starts, not at the full period length after it started (WNBA Q2 at 9:41: 1781 -> 1800); a period's last play ends at 0:00. Clock minutes are Int32 (WBB seconds Int32, NBA / WNBA Float64), not Float32. (#841)
- NBA / WNBA crosswalks: the archive team and player crosswalks no longer carry All-Star and other exhibition sides (e.g. WNBA 2026 TEAM SPOON / TEAM COOP); their games stay in the schedule crosswalk. (#786)
- NBA / WNBA player props:
nba_player_props()raises its documentedValueErrorwhen the player box logs carry nogame_date; it used to fail with polars'ColumnNotFoundErrorbefore the check ran. (#943) - NBA/WNBA:
nba_availabilityimputes missing GP% with the train-season median stored in the bundled artifact, not a median over the seasons being scored. (#850) - NBA/WNBA:
nba_player_props(as_of_date=)uses only box lines and ratings games dated strictly before the cut; the default is the target game's date (box logs, else schedule; else a newerrors.AsOfCutWarning), so a played game never sees its own or later lines. (#850) - NBA:
logistic_fit_irlsno longer overflows on separable data, andnba_rapmfits a single possession without a divide-by-zero warning. (#726) - NCAA discover / roster sweeps: a team whose page 404s is skipped without counting toward the "ban-suspect" abort after 5 failures in a row, as the capture stage already did. (#924)
- NCAA ESPN game crosswalk: a crosswalk written in this process is read back instead of the cached empty answer from before it existed. (#924)
- NCAA parse stage: a family whose parser crashed is recorded in a
parse_errorsfield of the game's JSON (it was an empty list, like a game with no shots), and the stage exits 1 when any game failed or carries one. (#924) - NCAA proxy pool:
load_proxybonanza_poolraisesAssetFetchErroron a 200 that is not the package JSON, notKeyError. (#920) - NCAA:
ncaa_espn_team_crosswalkfalls back to the bundled copy only on a failed or absent release fetch or a drifted asset; any other error raises.ncaa_mbb_box_scoresreports a dropped game through the module logger, notprint. (#907) - NFL / CFB play-by-play:
line_yardsfollows the standard adjusted-line-yards band (losses 120%, yards 0-4 100%, 5-10 50%, nothing past 10; cap 7), and line + second-level + open-field yards now sum to the carry (NFL was half a yard short on every 4+ carry).adj_rush_yardagecaps at 10. (#843) - NFL
advBoxScorerow order:team/situational/defensive/driveslist the home team first, so these four tables serialise in the same order in every process; before, their rows reshuffled from run to run. Values are unchanged. (#917) - NFL CSV loaders:
load_nfl_teams,load_nfl_ff_playeridsandload_nfl_ff_rankingsfetch through the HTTP gateway: 404NoDataError, 400ValueError, a rate limit retried thenAssetFetchError, a challenge page refused (on polars 2.0 every failure was a bareOSError). (#898) - NFL fourth down: the PAT make probability (
get_2pt_wp/get_2pt_probs,conv_1pt) scores the FG model at nflfastR's pre-2015 spot (yardline_100 = 3) before 2015, not the modern 15 for every season; new constantsPAT_YARDLINE_PRE_2015/PAT_YARDLINE_POST_2015/PAT_FIRST_SEASON_FROM_15innfl.model_vars. (#742) - NFL pbp:
opportunity_runmarks a carry that gained 4 or more yards; it was inverted (<= 4), so the box'srushing_opportunity_rateran about 0.62 instead of about 0.46. (#739) - NFL pbp:
opportunity_run,highlight_runandadj_rush_yardagegate onrush, as the CFB processor does, so rushing touchdowns and fumbled rushes are no longer dropped. (#739) - NFL, CFB: a half or game that ends on a timeout row ends on the play before it, which now takes
end_of_halfandEPA == -EP_start; the timeout row took it (EPA 0.0). (#832) - NFL.com Shield / 247Sports / MLS parsers:
parse_nfl_standingsno longer raises on a non-object week or a non-liststandings;parse_sports247_teams,_institution_rankingsandparse_mls_entityread a scalar array (or a non-listlist) as drift, not invented rows; 247Sports keeps a pandas-2 gap null, never"nan". (#945) - NFL.com Shield and Statcast parsers: records that are not a list, or a record that is not an object
(
parse_nfl_team(["a"]),{"rosters": 5}), are zero rows with aSchemaDriftWarningon pandas 2 and 3; it was an N x 0 frame on pandas 2, a raise on pandas 3. A null row (None/NaN/pd.NA) is no row. (#945) - NFL:
clean_nfl_pbpmatches nflfastR's 15fix_weird_pass_playskeys on nflverse pbp, whoseplay_idis Float64: the key cast goes through Int64 (..._1611, not..._1611.0), so those rows readpass0, as in nflverse. (#852) - NFL:
end_of_halfis true on a finished game's last play and on the play that ends regulation, so a non-scoring game-ending play scoresEPA == -EP_startand the last drive'sfixed_drive_resultfills; the 2002-05 feeds' untyped "End of the game." row is no longer a play. (#832) - NFL:
exp_qbrfeeds the bundled QBR booster in its trainer's order; it scored sack EPA as pass EPA, pass as rush and rush as sack. (#795) - NFL:
get_go_wpon a full nflverse frame no longer raises pandasPerformanceWarnings; output is unchanged. (#726) - NFL:
home_/away_wp_after_naivewere flipped on every change of possession (about 14 rows a game), andwp_after_naive/wpa_naiveread the next row (a Timeout, or a half's end), not the next real play (up to 0.38). Naive home WP now runs continuously into the next real play, as in nflfastR. (#973) - NFL:
NFLPlayProcess(ESPN and the CBS/Fox/Yahoo/Shield adapters) takes a play's end team/down/distance from the next play in the game and half, and keeps a half-ending plain snap's possession, not ESPN'send(corrupt 2014-2021); the published 2014-2021 ESPN NFL pbp and everything built from it need the reprocess. (#785) - NFL:
NFLPlayProcessreads a first down by penalty from the 2009+ NFL foul text (2002-2008 text names no accepted foul, so those seasons stay unrecovered), andseries/fixed_drivefollow nflfastR on muffed punts, timeout rows and the kickoff after a defensive touchdown; the ESPN NFL pbp and its series tables need the reprocess. (#806) - NFL:
td_playkeeps a scored "TOUCHDOWN NULLIFIED" row the try follows (foul enforced on the kickoff), and clears a touchdown reversed into a safety and, from 2009, an unscored "Kickoff/Punt Return Touchdown" with no touchdown in its text (2024 onside/short kicks): 34 rows 2006-2024 move, all to nflverse. (#840) - NFL:
td_play,pass_tdandrush_tdare False on a touchdown that did not stand: "TOUCHDOWN NULLIFIED by Penalty" and a replay-REVERSED score ESPN leaves unscored but still types "Passing/Rushing Touchdown". Team box TD counts now equal ESPN's box (291018018 NO passing 4, 401671740 TB rushing 2). (#808) - NFL: a half-ending play's
wp_after,def_wp_after,home_/away_wp_after,wpaandprog_drive_WPAfollow the next real play's WP (nflfastRlead(home_wp)): 20 half-end rows in 18 of 37 captures, plusprog_drive_WPAon 400791590's Timeout after its half end; 140 rows in 139 of 268 held-out 2003-24 games, max 0.325. (#969) - NFL: a kickoff the kicking team recovers (a muff, an onside kick) ends at the kicking team's next snap and is scored from the receiver's side, so its EPA is the loss nflverse gives it (2010 muff: +0.63 -> -3.82, nflverse -3.89). (#831)
- NFL: a kickoff's net spot is read from the receiving team's next snap only; ESPN sometimes files a kickoff inside the kicking team's drive, whose next snap was read as the receiver's. (#831)
- NFL: a pre-2009 punt (ESPN's bare "Punt" feed) ends at the receiver's next snap, like a kickoff, not at ESPN's end yard line: summed |EPA - nflverse| on the 93 pre-2009 punts #856 moved (644 sample games) goes 86.2 -> 11.3 (74.2 before #856), and on all 3,315 pre-2009 punts there 1,520 -> 525. (#963)
- NFL: a pre-2009 return ESPN types "Punt/Kickoff Return Touchdown" with no try after it is no longer a touchdown: 17 rows over all 6,749 nfl-raw games, all 2005-08, summed |EPA - nflverse| 103.4 -> 2.1. (#975)
- NFL: a punt from 2009 on also ends at the receiver's next snap, and every punt takes that snap's clocks, so
published 2009-2026 punt EPA moves closer to nflverse, as do the rows after a punt (
EP_between,lag_EP_end,prog_drive_EPA) and 4 pre-2009 punts. (#971) - NFL: a quarterback with no sack, rush or penalty play gets 0 for that
exp_qbrinput, as the QBR trainer did, instead of 0/0 = NaN, which the booster read as missing. Spearman ofexp_qbrvs ESPN Total QBR over the 573 rated 2023 quarterback-games rises from 0.807 to 0.834. (#802) - NFL: a safety typed otherwise, left unscored or with no "safety" in its text takes the -2 overlay and keeps its 2 points: all nfl-raw, 60 rows 211.2 -> 13.3 (48 before 2009, 10 in 2009-15, 2 in 2025), every nflverse-matched row closer, 148 score rows in 8 games now nflverse's. Seasons 2002-15 and 2025 change. (#975)
- NFL: a touchback kickoff (its text says touchback, or the receiver next snaps at the touchback spot) scores
EP_endat its start clock, so ESPN's end clock no longer moves its EPA (2007 KC kickoff at 0:23 with a 1:08 end clock: +0.52 -> 0, nflverse 0), at the touchback spot when ESPN's end clock is 0; WPA is unchanged. (#856) - NFL: a touchback kickoff ends at the season's touchback spot, not a fixed 75, so its EPA is 0 in every season (it
read +0.35 before 2016, -0.25 / -0.48 in 2024 / 2025); a 2024+ landing-zone touchback keeps its next snap at the 20.
nflverse still scores 2024+ kickoffs from 75 (touchback
epa+0.26 / +0.35 in 2024 / 2025). (#831) - NFL: before 2014, a play ESPN files under a later period than the plays on both sides of it takes their period
(727 rows 2002-13, every one that joins agreeing with nflverse
qtr), so a half no longer "ends" on a misfiled kickoff and its drives, clock and EPA follow; 261022011 now has one first-half end. (#856) - NFL: kickoff and missed field goal EPA score the next possession's 1st & 10: an unscored kickoff at the receiver's next snap (1st & goal inside the 10), a missed field goal at the spot of the kick (the 20 when that is inside it), not ESPN's down -1 or stale end. (#810)
- NFL: overtime
wp/vegas_wpfollow the season's overtime rule (model_vars.OVERTIME_FORMATS): sudden death, nflfastR's One_FG form with a per-gameDrive_Diff, or both-teams-possess (postseason 2022+, regular season 2025+), where an opening-drive touchdown no longer ends the game; spring-football overtime gets null. (#744) - NFL: the EPA scoring overlay reads the corrected touchdown flags: a kicking-team recovery returned for a score takes the kicker's touchdown (2010: +6.30 -> -7.54, nflverse -7.67), and a touchdown-typed row whose score did not stand takes no touchdown value (2024 short and onside kicks: 5.13 / 5.75 -> 0.67 / 1.02, nflverse 0.93 / 1.42). (#856)
- NFL: the kickoff-touchback spot is now the rule spot per season (
model_vars.touchback_yardline: 80 / 75 / 70 for 2024 / 65 from 2025) in the EP feature substitution, the overtime re-score and the ESPNyds_kickoff_return; nflfastR still scores 2024+ kickoffs at 75, so kickoff-rowepdiverges from nflverse there by design. (#744) - NFL: the processor's summary-pickcenter odds are Python scalars (they were shape-(1,) arrays), so they round-trip
through
odds_override, and an all-null pickcenter spread takes the default path instead of raisingIndexError. (#852) - NHL / PWHL player impact:
build_stintscredits a shot or goal at a line-change second to the line on the ice before the change, not the one after it (scorer on ice: 11 -> 22 of 25 PWHL and 1 -> 13 of 14 NHL fixture goals; PWHL xG off the shooter's stint 6.73 -> 3.30 of 25.0). RAPM, WAR, unit and special-teams values move. (#960) - NHL:
espn_nhl_pbpreads ESPN's NHL clock as elapsed time, sostart/end.*_seconds_remainingcount down within each period (playoff OT 20 min, regular-season 5, shootout 0; in OT the game clock is the OT period clock, as in fastRhockey) and no row ends after it starts. (#857) - NHL:
load_nhl_game_rosters()accepts published roster seasons from 2010 instead of rejecting seasons before 2024. (#765) - NHL:
load_nhl_pbp_lite()reads the currentplay_by_play_lite_<season>files (2010-2027, every legacy column plusgame_date); the legacyplay_by_play_<season>_litefiles stopped at 2026, so the current season was missing. (#775) - NHL:
nhl_skater_warno longer emits aplayer_id0 row when a faceoff or penalty names no player on one side. (#846) - NHL: the
nhl_scoreboard(team=...)route is never cached, like/scoreboard/now. (#880) - NHL: twelve release loaders accept 2010 (the 2009-10 season), where every NHL release starts:
game_info,goalie_boxscores,linescore,penalties,scoring,scratches,skater_boxscoresandthree_starsstarted at 2024,officials,shifts,shootoutandshots_by_periodat 2025 (allload_nhl_*). (#775) - P. LEAGUE+ (
pleague):action_enin the play-by-play is read from each row's own phrase, so free throws say which throw of how many ("free throw 2, made") instead of every one reading"free throw 1 of 3 awarded, ...". (#892) - Parsers: 153 provider parsers (HockeyTech, NFL.com Shield, Fox, CBS, 247Sports, EuroLeague, Sleeper, NFL Pro,
Kalshi, Polymarket, soccer, international basketball, European hockey) return zero rows for an error envelope, an
empty
{}record or a wrong-typed body. (#923) - Parsers: a
nullrow in a row list is dropped wherever it sits, instead of becoming an all-null row, raising, or (as the first row) changing the frame's shape; a list holding only nulls reads as an empty one. Any other row that is not an object is still schema drift. Covers the ESPN, NHL and MLB Stats API parsers. (#953) - Parsers: the NHL api-web / EDGE, MLB Stats API and stats.nba.com parsers return zero rows for a
None,"", list or{code, message}error-envelope body instead of raising or flattening it into a row. (#907) - Parsers: with pandas 2 installed, a row list that stops holding objects now warns
SchemaDriftWarningand returns zero rows, as with pandas 3; it came back as an N x 0 frame with no warning. Covers the ESPN, NHL api-web / EDGE / Stats REST / Records and MLB Stats API parsers, andparse_draft's inline rounds no longer raise. (#941) - PWHL:
pwhl_game_inforeturns the publishedload_pwhl_game_infocolumns,pwhl_player_boxthe fastRhockey skater and goalie frames (ids Int64), andpwhl_player_infoone row of player bio. (#851) - PWHL:
pwhl_game_info,pwhl_player_boxandpwhl_player_inforeturn data again; they read the bare-objectstatviewfeedgameSummary/playerreplies asSiteKitenvelopes and so returned an empty frame every time. (#851) - PWHL:
pwhl_skater_rapm,pwhl_unit_ratings,pwhl_special_teams_valueandpwhl_skater_warrun onload_pwhl_pbp+load_pwhl_shiftsoutput; they raisedColumnNotFoundError: "secondary_type".pwhl_team_ratings/pwhl_player_propsread PWHL data; they returned NHL ratings and props. (#846) - Python 3.9:
sportsdataverse.cfbimports on 3.9 again (cfb_drive_summaryandcfb_situational_statsused runtimeX | Yannotations); a test walks every module for runtime PEP 604/585 annotations. (#865) - RealGM: every
realgm_*function raisesAssetFetchErrorwhen the page is still Cloudflare's "Just a moment..." challenge; it returned a zero-row frame. (#919) - Release loaders: a body that arrived whole but does not parse is re-raised at once, without a second fetch, and
download()no longer decodes anapplication/octet-streambody as JSON. (#898) - Release loaders: a refused or reset connection raises
AssetFetchError(it leakedrequests.ConnectionError); a failed read is checked with a one-byte ranged GET instead of a full re-download, and a reachable asset whose read failed in transit is read again, a second failure classified too (404NoDataError, elseAssetFetchError). (#898) - Release utilities:
sportsdataverse_uploadstops retrying a permanentghfailure (HTTP 400/401/404, a 403 that is not a rate limit, a 422 other thanalready_exists, a missing release), judged on gh's stderr, instead of sleeping ~645 s. (#899) - Runtimes: the Data API id-map lookup no longer returns an error body as the row (dispatch falls back);
pff_api_*returns{}on a 204/205; with the opt-in cache on, statcast / torvik return the same JSON on a hit as on the first call; the On3, The Odds API and statcast player parsers return zero rows for a hostile body. (#921) - sdv-docs index: stdlib and third-party objects a module re-exports (
typing.Any,xgboost.Booster,tqdm,functools.lru_cache, 14 in all) are no longer indexed as sdv-py functions. SDV partials and type aliases whose__module__isfunctoolsortypingstay indexed. (#746) - sdv-docs: the server opens an index whose path contains
?,#or%; such a path used to end the SQLite URI early and silently open a different, empty file. A corrupt or foreignSDV_DOCS_DBnow gets anindex unreadable: …answer instead of a raisedDatabaseError. (#746) - sdv-docs: when the
mcpimport fails,sdv-docsprints the import error after the install hint, so an installed but incompatiblemcpis visible. (#746) - Soccer:
soccer_open_dataset/soccer_open_eventsretry a truncated StatsBomb events file once, after evicting the partial download kloppy cached (only that file; kloppy's cache setting is untouched), then raiseAssetFetchErrornaming the URL instead of a rawJSONDecodeError. (#1014) - Spring football:
get_sf_constants(league, season=)resolves the UFL 2024 / 2025 / 2026, XFL and CFL rulesets. (#738) - Statcast search: a 200 chunk that is not a Statcast CSV (an HTML or error page) raises
AssetFetchErrorinstead of adding a junk row or reading as "no games"; a dropped connection does too. (#919) - stats.nba.com / stats.wnba.com: a float or numpy
GameIDis sent as"0022400001"; it was sent as"22400001.0", which the host rejects with HTTP 400. A malformedSDV_PY_NBA_STATS_*value raises naming the variable. (#928) - stats.ncaa.org cache: a cached bm-verify shell, sub-1 KB stub or Access Denied page is re-fetched; it was served
forever, so every parser read zero rows for that game until
force=True. (#920) - stats.ncaa.org: an HTTP 400 or 422 (without a WAF ban or challenge page) raises
ValueErrorafter one request; it rotated the whole proxy pool and ended inAssetFetchError. (#920) - TheSportsDB: the default free key is
123(key3now answers HTTP 403), and a free-key list that reaches the key's row cap warns that it is probably truncated. (#919) - Validation:
validate_gameno longer crashes under polars 2.0 when the score columns are Float64, and a failure building the standing-scrimmage frame is reported asbox.standing_scrimmage_built(warning) instead of silently lowering coverage. (#899) - VTB Infobasket: an empty string in an id, rank or number column is null; the roster
rank(blank in every sample) is documented as unobserved and typed Int64. (#864) - WBB / WNBA release helpers:
helper_wbb_officials/helper_wnba_officialsskip a null official, return a zero-row frame with their columns when there are none, and no longer merge two id-less officials with equal fields. (#878) - WBB / WNBA:
find_athlete(..., league="wnba" | "wbb")no longer raisesTypeError(download()gotreturn_parsed):espn_wbb_team_roster/espn_wnba_team_rosternow acceptreturn_parsed=False, the generated wrappers' spelling ofraw=True. (#1017) - WBB NCAA:
ncaa_wbb_game_pbp/ncaa_wbb_play_by_playuse the period model of the game's era (halves through 2014-15, quarters from 2015-16), not quarters always, so a pre-2016 game no longer parses to zero rows. A newseason=pins the era; without itinfer_wbb_period_modelreads it from the first-period clock. (#738) - WBB release helpers:
helper_wbb_game_rostersreads"false"/"F"as false (Ras.logical), and the ESPN stat pivot's float coercion maps NaN to null. (#878) - WBB:
espn_wbb_calendaraccepts season 2001 (ESPN serves a women's college basketball calendar from 2000-01); it refused every season before 2002. (#860) - WBB:
ncaa_wbb_game_pbp/ncaa_wbb_play_by_playinfer the era from the page for a NaN or blankseason, as forNone; they bound the quarters model and a halves-era game returned 0 rows. (#887) - WBB:
ncaa_wbb_game_pbp/ncaa_wbb_shot_locationsreadseason=2015.0as 2015 (halves); it became"2015.0", bound the quarters model and a halves-era game returned 0 rows. (#853) - WBB:
period_and_sec_left(the NCAA shots'period/sec_left) readsseason=2015.0as 2015 (halves); it became"2015.0"and labelled a halves-era shot with the quarters model. (#887) - WNBA / Summer League lineups: rotation lineups are timed on the league's own periods (WNBA 10-minute quarters, halves before 2006; Summer League 10-minute quarters), not NBA 12-minute ones; a malformed rotation returns an empty frame and every engine falls back to pbp lineups. (#818)
- CFB:
load_cfb_passing,load_cfb_receivingandload_cfb_rushingdeclare the columns the assets gained (dispersion_games,EPAplay_sd,boom_rate,stuff_rate, ...). - CFB: the NCAA mapper fixes quarter markers, the score walk, overtime interception flags, overturned yardage and same-row penalty enforcement; no-play rows carry no yardage, and block-printed tries go to the kicking team. (#557, #550, #560)
- CFB: about 650 plays ESPN scores but no text rule named (frozen-board pick-sixes, fumble returns, field goals) now score; textless copies and untyped admin rows ("Begin Drive", quarter markers, lone try fragments) are dropped.
- CFB: a play that ends a half or a finished game leaves a possession worth nothing (EP_end 0, EPA -EP_start), now also for a finished game's last play and regulation's last play before overtime.
- CFB: a returned kickoff whose end down is outside 1-4 (ESPN's -1 sentinel) ends at down 1, so its EP_end is the next snap's EP_start.
- CFB:
end.TimeSecsRem/end.adj_TimeSecsRemare the next play's start clock (they were the previous play's), and the last play of a half or game ends at 0:00; EPA moves most at period ends. - CFB: 2007-13 touchdowns ESPN filed as their own extra-point kick carry the snap's down and distance (was -1), so the EP model no longer scores them as no down.
- CFB: blocked field goals keep ESPN's type instead of becoming "Penalty", "Extra Point Missed" or a plain "Blocked Field Goal" (sportsdataverse/cfbfastR#175); plays with null join keys are never dropped as copies. (#641)
- CFB: win probability in overtime and the final seconds uses the new
cfb_wp_overtimecorrection, and made field goals, decision surfaces and two-point shootouts are valued correctly; everywp_*/wpamoves, andfg_wp/make_fg_wp/miss_fg_wp/xp_wpare Float64. - CFB: completions written without "complete to ... for N" (ESPN 2024-25) keep their receiving
yards from ESPN's
statYardage, so passing / receiving yards and box scores move. - CFB: a tackle is credited to the tackler's own team from the game roster, so coverage and
post-turnover tackles leave the opponent's tackle table;
def_pos_teamintackles/position_group_tacklesis now the tackler's team. - CFB: plays ESPN files twice under new ids (stub echoes, drive batches at the start clock, copies around a timeout) are dropped before the adjacent-copy dedupe; play counts, EPA/play and success rate move in affected games.
- CFB: losses written "for N yards loss" or "for 1 yard loss" (ESPN 2025) no longer read as
gains in
yds_rushedandyds_receiving. - CFB: fumbles in ESPN's 2025 text format and the new
Fumbletype keep theirrush/passflags, so pass / rush aggregates (havoc, EPA/play, success rate) no longer drop them. - CFB: the usage box no longer glues a two-player assist into one phantom tackler, and
create_usage_box(rosters=)fillsposition_group_usage/position_group_tacklesfor historical games. - CFB: ESPN's 2025 jersey-style kick text fills kick distances, return yards, touchbacks, fair
catches and kicker / returner names, and
st_kickerslists a kicker once per team. - Cache: a scoreboard request whose
dates=include today or a future day now bypasses the response cache (no read, no write); a wholly historical date keeps the 30-day TTL, and an explicitcache_ttl=still wins. - Docs: descriptions mined from hoopR / wehoop no longer say "
team_detail = TRUEonly" (orathlete_detail/position_detail) for columns the Python parsers always return. - Docs: each reference page's Valid URL and docstring
Example URL:is the URL its example call requests (ESPN Core v2 child resources, default params);espn_<lg>_summarydocuments that it returns a dict. - Docs:
nba_stats,wnba_statsandon3return tables are generated from parser output on real captures (e.g.fg3m->fg3_m), and multi-result-set endpoints document their dict; wrapper behaviour is unchanged. - MLB:
mlb_expected_statscounts only plate-appearance-ending rows forpa,aband the wOBA denominator (raw pitch rows had pushedpato ~3,400, deflatingxba/xslg), andintent_walkis no longer an at-bat. - NBA / WNBA / MBB / WBB:
espn_nba_pbp,espn_wnba_pbp,espn_mbb_pbp,espn_wbb_pbpread the spread from a one-provider pickcenter, pair it with the same provider's favorite, flag every team timeout and fix MBB 2OT+ end seconds;helper_<lg>_pickcenterreturns plain floats / bools. - NFL: a strip-sack (type 80) credits the recovery to the defence, not the offence. (#546)
- NFL / CFB: processor bug sweeps: timeouts, roof, spread sign, re-run idempotence, dedupe, yard line and end clock (NFL), and C3-C40 plus the NCAA rounds (CFB). (#503, #504, #506, #514, #517, #519, #526, #530, #532, #533)
- NFL / CFB:
sec_per_playinfootball.tendenciescounts regulation drives only, each for its own offense, so overtime 0:00 drives and drive ids shared by two offenses no longer distort pace. - NFL / CFB:
aggregate_usage_boxkeeps one season row per player, keyed on(team, player_id), instead of splitting a player whose name or position group changed. - NFL / CFB: a pick-six or fumble-return touchdown no longer counts as the offense's conversion
or touchdown in
football.tendencies,football.usage_boxandfit_third_down_curve. - NHL, ESPN, NFL, KenPom: the twelve
nhl_edge_*_top_10boards return data (always empty before);espn_<league>_transactionsusesparse_transactions;load_nfl_ff_rankingsno longer readsrank_deltaas String early in a season; KenPom examples use ids KenPom recognises. - PFF: the legacy
pff_*passing / receiving and thepff_apiposition / team return tables now describeavg_time_to_throw(per dropback),aimed_passesand receivingpositive_epa_percentcorrectly, as already done for the player summaries. (#689) - PFF: 19
pff_api_*per-player and coverage-matrix routes gain their return-table columns, andpff_api_player_rushing_direction()/pff_api_player_snaps_summary()return rows instead of a zero-row frame. - Polars: code polars 2.0 rejects now runs on 1.x and 2.0 with unchanged 1.x output: the
*_pbpclock split,start.down/start.distance/end.down/end.distancecast toInt64, String-to-Date casts andexplode()on empty lists. - Polars: on polars 2.0, a column R's arrow wrote with the
arrow.r.vctrsextension type (such asgame_json_urlin the NHL and PWHL schedules) reads as its storage type, not anExtensioncolumn, which no.strop, comparison or join accepts; importing sportsdataverse registers it. (#723) - Polars: on polars 2.0,
pl.read_parquet(url)gets HTTP 501 from GitHub release URLs; the release loaders read withuse_pyarrow=Trueand work. - Soccer:
soccer_open_events()andsoccer_open_dataset()no longer raiseAttributeErrorin a fresh interpreter. - stats.ncaa.org: the fetch layer passes the new
/stats_termsTerms gate without returning or caching it as content (#568), fits its three-view cap and backs off on refusals (#569), and rotates the proxy when a network error interrupts acceptance (#570).
Security
- Cache: the opt-in response cache stores bodies after credential scrubbing, not before, so a token or API key echoed in a body or URL never lands on disk. (#865)
- Cached bodies: only the request's own credential values are scrubbed from a stored body (now including
api_token=/user_key=), so a signed media URL in the body (X-Amz-Signature=) is served as the live call gave it. (#897) - Redaction: a
Bearer/Basiccredential and a wholeCookie:header line are hidden, and a failed request'sX-Api-Key/x-api-secret/X-Authorizationheaders are dropped withAuthorizationandCookie. (#897) - Redaction: error messages, retry log lines and cached URLs also hide a URL's
user:password@,appkey=,access_key=,subscription-key=,sig=,signature=,auth=,pass=andAuthorizationvalues. (#897) - Response cache:
cache_ttl=0given as anintno longer raisesAttributeErrorwhen a cache mode is on, and a body that cannot be cached, or a binary one (application/octet-stream, images, parquet), is not JSON-decoded. (#897) - Response cache: a request that authenticates outside its URL (an
Authorization,Cookie,X-Api-Keyor other credential header, or asession=holding cookies) is never cached, so a second credential in the same process or cache dir is not served the first one's body (PFF Premium,api.nfl.com, NFL Pro, KenPom, Her Hoop Stats). (#897) - Security: re-lock certifi (2026.10.23, compromised emSign intermediates), soupsieve, cryptography, nbconvert, mistune, tornado, virtualenv and opentelemetry-api past their advisories. The Python 3.10 resolution keeps Pillow 12.3 and virtualenv 21.14.5, whose fixes need Python 3.11+. (#1021)
- Subscription logins: the KenPom / Her Hoop Stats session cache tells passwords apart (a changed password logs in again), threads that miss it together log in once, and the 247Sports token and On3 buildId are minted under a lock. (#897)
- HTTP: a credential in a query string (The Odds API
apiKey, HockeyTechkey, Foxapikey, ...) readsREDACTEDin everydl_utils.downloadlog line, error message and chained exception; The Odds API wrappers raiseAssetFetchErroron a non-2xx answer instead of returning it as odds.
Data
- Cricket: pooled constants move to T20 149.5/42/33 and ODI 249.3/76/59, and both holdout fixtures carry
match_date. Holdout Brier 0.1898 -> 0.1882; max per-decile gap 0.0326 -> 0.0369 (gate 0.05). (#743) - Cricket: the win-probability artifacts are refit on Cricsheet male internationals 2002-2026 (3,581 T20I, 2,589 ODI): a regime-keyed surface with per-cell support and a calibrator fitted on the regime-aware probabilities. (#743)
- MBB / WBB pbp: 2014-2026 free throws (ESPN types made and missed alike "MadeFreeThrow") now sit on the line in
coordinate_x/_y, transformed from (25, 13.75) like NBA / WNBA's;coordinate_x_raw/_y_rawkeep ESPN's (25, 0). (#844) - MBB / WBB pbp: hoopR / wehoop's case-sensitive "Free Throw" match never caught those rows, so the published MBB / WBB files keep ESPN's coordinates on them until the next republish corrects them. (#844)
- NCAA team ids: 2026-27 MBB (365) and WBB (363) ids join the bundled
ncaa_teamids_{mbb,wbb}.csvand the NCAA ↔ ESPN team crosswalks, every team matched (West Florida joins the ASUN, New Orleans is now LSU New Orleans, Saint Francis left Division I). (#809)