Breaking in 4.0.0

• Integer id columns are decimal strings — Every id column of integers (id, *_id, game_pk, playerId, …) comes back as exact decimal strings on every surface — parsers, producers, loaders, HockeyTech analytics. Compare and join ids as strings; Number(row.game_id) for a safe number back. (changelog)
• Typed wrapper params and loader rows; strict mode — TypeScript only. A param the endpoint does not have, a missing required path param or a non-boolean bool param is a type error; parser rows are Record<string, unknown>; loader rows are their generated row types. (changelog)

ESPN cross-league reference

Every league below exposes the same generated espn<League><Endpoint> surface (e.g. espnNbaScoreboard), bound from a single YAML source of truth. Each method is also available under its snake_case name (espn_nba_scoreboard) for parity with the Python / R packages. Pick a league for its full endpoint table, or try any call live in the playground.

Every endpoint also accepts { parsed: true } to return tidy rows instead of raw JSON — see ESPN parsed returns for the column reference (116 endpoints across 22 parsers).

Some leagues additionally ship native (non-ESPN) API wrappers — NBA Stats API (stats.nba.com) (nba), WNBA Stats API (stats.wnba.com) (wnba), KenPom (mbb), NFL.com Shield API + PFF Developer API + NFL Pro (Next Gen Stats) (nfl), MLB Stats API + Baseball Savant / Statcast (mlb), NHL api-web (game feed) + NHL EDGE (player tracking) + NHL Stats REST + NHL Records (nhl), MLS web API (mls), NWSL (StatsPerform SDP) (nwsl). They're listed in the Native API sections of each league page; the native column below counts them. The Sources & coverage page lists every upstream source with its auth, ownership and parity.

League	sport	ESPN slug	scopes	wrappers	native
nba	basketball	nba	universal	116	128
wnba	basketball	wnba	universal	116	111
nbagl	basketball	nba-development	universal	112	—
mbb	basketball	mens-college-basketball	universal, ncaa	122	30
wbb	basketball	womens-college-basketball	universal, ncaa	122	—
cfb	football	college-football	universal, ncaa, football	125	—
nfl	football	nfl	universal, football	118	99
mlb	baseball	mlb	universal, mlb	117	117
nhl	hockey	nhl	universal	113	127
mch	hockey	mens-college-hockey	universal, ncaa	118	—
wch	hockey	womens-college-hockey	universal, ncaa	118	—
college_baseball	baseball	college-baseball	universal, ncaa	122	—
college_softball	baseball	college-softball	universal, ncaa	121	—
ufl	football	ufl	universal	113	—
xfl	football	xfl	universal	112	—
cfl	football	cfl	universal	112	—
soccer	soccer	eng.1 *(param)*	universal	112	—
epl	soccer	eng.1	universal	113	—
laliga	soccer	esp.1	universal	112	—
bundesliga	soccer	ger.1	universal	112	—
seriea	soccer	ita.1	universal	112	—
ligue1	soccer	fra.1	universal	112	—
mls	soccer	usa.1	universal	113	12
ligamx	soccer	mex.1	universal	112	—
ucl	soccer	uefa.champions	universal	113	—
uel	soccer	uefa.europa	universal	112	—
nwsl	soccer	usa.nwsl	universal	112	9
wwc	soccer	fifa.wwc	universal	112	—
wc	soccer	fifa.world	universal	112	—
cricket	cricket	eng.1 *(param)*	universal	112	—

Standalone provider namespaces

Native providers that aren't a single ESPN league — each gets its own sdv.<namespace> surface and reference page. Cross-sport providers (odds, cbs, …) live under Providers in the sidebar; sport-specific ones (torvik → Basketball, hockeytech → Hockey) nest under their sport.

Namespace	sport	provider	wrappers
odds	cross-sport	The Odds API	10
recruiting	cross-sport	247Sports	25
sports247	cross-sport	247Sports RDB, 247Sports site pages	47
cbs	cross-sport	CBS Sports	82
fox	cross-sport	Fox Sports	38
yahoo	cross-sport	Yahoo Sports (scores), Yahoo Sports	109
hockeytech	Hockey	HockeyTech / LeagueStat	16
torvik	Basketball	BartTorvik (T-Rank), BartTorvik women's (T-Rank)	6
on3	cross-sport	On3 Recruit Database	78
asa	Soccer	American Soccer Analysis	16

Same call, every league

await sdv.nba.espnNbaScoreboard({});
await sdv.nfl.espnNflScoreboard({ week: 1, seasonType: 2 });
await sdv.soccer.espnSoccerScoreboard({ league: 'eng.1' });

Native (non-ESPN) APIs

await sdv.mlb.mlbSchedule({ sportId: 1, date: '2024-07-01' });
await sdv.nhl.nhlWebPbp({ gameId: 2023030417, parsed: true });
await sdv.nfl.nflStandings({ season: 2024, seasonType: 'REG', week: 1 });

v4 names

Since v4 every wrapper carries sdv-py's name (athlete → player, event → game, …). Pre-v4 names still work as deprecated aliases (one DeprecationWarning per name) — see Deprecated names.

Dataset loaders

load* functions read the published SportsDataverse release assets (parquet) — play-by-play with EPA/WP, schedules, rosters, box scores, ratings, player value — the way sportsdataverse-py's load_* functions do. Node only.

Namespace	loaders
cfb	71
mbb	34
mlb	32
nba	41
nfl	29
nhl	27
pwhl	21
wbb	34
wnba	34

Generated by tools/codegen/generate.mjs from tools/codegen/endpoints/releases.yaml (vendored from sdv-py) — see How this library is built.