Leagues

LeagueCodeStatusNotes
MLBmlbLiveRegular season and postseason. Spring training excluded.
NFLnflPlannedTarget: regular season opener after MLB stabilizes.
NBAnbaPlannedTarget: opening night following NFL onboarding.
NHLnhlPlannedTarget: alongside NBA.
NCAAFncaafFutureRequires player identity coverage at NCAA scale.
NCAABncaabFutureSame dependency as NCAAF.
WNBAwnbaFutureLow operational cost; added opportunistically.
EPL, La Liga, Bundesliga, Serie A, Ligue 1, MLSsoccer codesFutureSeparate stat taxonomy — shots, passes, cards, goals. Distinct from US box-score style.
AFL, NRLAustralianFutureContingent on data-source availability at the required fidelity.

Status definitions matter for integration planning. Live means the oracle is actively posting assertions and consumer contracts can rely on them in production. Planned means the operator has committed to adding the league and has a specific sequencing in mind, but no commitment on date — integrations that depend on a planned league should not go live ahead of the oracle. Future means the league is in scope for the project's broader roadmap but has not been prioritized and may remain unscheduled indefinitely.

Canonical team strings

The canonical event ID derivation depends on exact team strings. A typo in the consumer's event ID computation produces a different hash and no registry hit, so consumers must use the published strings byte-for-byte.

For the MLB launch, the canonical strings are the standard full franchise names as used by MLB.com — "New York Yankees", "Los Angeles Dodgers", "St. Louis Cardinals", and so on. The full list of 30 franchises is published in the reference appendix of the repository and does not change mid-season. When a team relocates or rebrands, the canonical string updates with the league's official change.