Skip to main content

Sportradar Atrium — additional Python functions — Sportradar Atrium embed API: lnb_standings–lpb_pbp

lnb_standings​

lnb_standings(season: 'Optional[int]' = None, season_id: 'Optional[str]' = None, competition_id: 'Optional[str]' = None, locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Standings of a LNB (France) season.

LNB (France) (men's); season rule: END year (2026 = 2025-26; the site's own year is the START year).

Convenience wrapper: a thin binding of atrium_standings to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental.

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneSeason END year (see the season rule above). Omit season and season_id for the site's current season.
season_idOptional[str]NoneSeason UUID (season_id in the seasons listing); skips the END-year lookup.
competition_idOptional[str]NoneCompetition UUID (a site carries many: conferences, cups); needed when several share the season.
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_idStringSeason UUID of the table.
season_end_yearInt64Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
groupStringLabel of the table when the standings hold several groups; null for a single table.
positionInt64League table position (1 = first).
entity_idStringTeam UUID of the row.
team_nameStringTeam name as the site prints it.
is_current_teamBooleanTrue for the team the page was opened for (team context); false on a plain standings request.
logo_urlStringURL of the team logo image.
winsInt64Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
lossesInt64Games lost (team, this table).
playedInt64Games played (LNBP and the compact standings) (team, this table).
standing_pointsInt64League table points (LNBP) (team, this table).
win_percentageFloat64Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_forInt64Points scored over the season (team, this table).
scored_againstInt64Points conceded over the season (team, this table).
point_differenceInt64Point differential over the season (team, this table).
result_string_homeStringHome results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_homeInt64Points scored in home games (team, this table).
scored_against_homeInt64Points conceded in home games (team, this table).
point_difference_homeInt64Point differential in home games (team, this table).
result_string_awayStringAway results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_awayInt64Points scored in away games (team, this table).
scored_against_awayInt64Points conceded in away games (team, this table).
point_difference_awayInt64Point differential in away games (team, this table).
streakInt64Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_homeInt64Length of the current run of home results (sign convention unverified) (team, this table).
streak_awayInt64Length of the current run of away results (sign convention unverified) (team, this table).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnb_standings
lnb_standings(season=2026)

lnb_team_box​

lnb_team_box(fixture_id: 'str', locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Team box score of a LNB (France) game.

LNB (France) (men's); season rule: END year (2026 = 2025-26; the site's own year is the START year).

Convenience wrapper: a thin binding of atrium_team_box_score to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental.

Parameters

ParameterTypeDefaultDescription
fixture_idstrFixture UUID (fixture_id in the schedule).
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_idStringGame UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_idStringSeason UUID of the game.
entity_idStringTeam UUID (from the fixture's isHome flag).
sideStringSide of the game the row belongs to: home or away (from the fixture's isHome flag).
minutesStringTime played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (team, this game).
seconds_playedInt64Time played in whole seconds, parsed from minutes (team, this game).
pointsInt64Points scored (team, this game).
reboundsInt64Total rebounds (team, this game).
rebounds_offensiveInt64Offensive rebounds (team, this game).
rebounds_defensiveInt64Defensive rebounds (team, this game).
assistsInt64Assists (team, this game).
stealsInt64Steals (team, this game).
blocksInt64Shots blocked (team, this game).
blocks_receivedInt64Own shots blocked by an opponent (LNB only) (team, this game).
turnoversInt64Turnovers (team, this game).
fouls_totalInt64Fouls committed (team, this game).
fouls_drawnInt64Fouls drawn (committed against the player or team; LNBP only) (team, this game).
plus_minusInt64Plus/minus, the point differential while on court (LNB only; null in some team lines) (team, this game).
efficiencyInt64Efficiency rating, from the site's own formula (team, this game).
field_goals_madeInt64Field goals made, two- and three-pointers together (LNBP only) (team, this game).
field_goals_attemptedInt64Field goals attempted (LNBP only) (team, this game).
field_goals_percentageFloat64Field-goal percentage, 0-100 (LNBP only) (team, this game).
points_two_madeInt64Two-point field goals made (team, this game).
points_two_attemptedInt64Two-point field goals attempted (team, this game).
points_two_percentageFloat64Two-point percentage, 0-100 (team, this game).
points_three_madeInt64Three-point field goals made (team, this game).
points_three_attemptedInt64Three-point field goals attempted (team, this game).
points_three_percentageFloat64Three-point percentage, 0-100 (team, this game).
free_throws_madeInt64Free throws made (team, this game).
free_throws_attemptedInt64Free throws attempted (team, this game).
free_throws_percentageFloat64Free-throw percentage, 0-100 (team, this game).
points_fast_breakInt64Fast-break points (LNBP only) (team, this game).
extra_fouls_totalInt64Fouls committed (team, credited to the team rather than a player).
extra_reboundsInt64Total rebounds (team, credited to the team rather than a player).
extra_rebounds_defensiveInt64Defensive rebounds (team, credited to the team rather than a player).
extra_rebounds_offensiveInt64Offensive rebounds (team, credited to the team rather than a player).
extra_turnoversInt64Turnovers (team, credited to the team rather than a player).
total_biggest_leadInt64Biggest lead of the game, in points (team, game total).
total_biggest_scoring_runInt64Longest unanswered scoring run of the game, in points (team, game total).
total_field_goals_percentageFloat64Field-goal percentage, 0-100 (LNBP only) (team, game total).
total_free_throws_percentageFloat64Free-throw percentage, 0-100 (team, game total).
total_lead_changesInt64Number of lead changes in the game (team, game total).
total_points_fast_breakInt64Fast-break points (LNBP only) (team, game total).
total_points_from_benchInt64Points scored by non-starters (LNBP only) (team, game total).
total_points_from_turnoverInt64Points scored off opponent turnovers (LNBP only) (team, game total).
total_time_in_leadStringTime the team led, as an ISO 8601 duration (PT36M11S) (team, game total).
total_time_in_lead_secondsInt64Time the team led, in whole seconds (team, game total).
total_turnoversInt64Turnovers (team, game total).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnb_schedule, lnb_team_box
games = lnb_schedule()
lnb_team_box(fixture_id=games['fixture_id'][0])

lnb_teams​

lnb_teams(season: 'Optional[int]' = None, season_id: 'Optional[str]' = None, competition_id: 'Optional[str]' = None, locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Teams of a LNB (France) season.

LNB (France) (men's); season rule: END year (2026 = 2025-26; the site's own year is the START year).

Convenience wrapper: a thin binding of atrium_teams to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental.

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneSeason END year (see the season rule above). Omit season and season_id for the site's current season.
season_idOptional[str]NoneSeason UUID (season_id in the seasons listing); skips the END-year lookup.
competition_idOptional[str]NoneCompetition UUID (a site carries many: conferences, cups); needed when several share the season.
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_idStringSeason UUID of the team list.
entity_idStringTeam UUID (entity): one id per club across seasons, shared by every site that shows the team.
nameStringTeam name in the site's language.
image_urlStringURL of the Sportradar-hosted image (400 px).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnb_teams
lnb_teams(season=2026)

lnbp_pbp​

lnbp_pbp(fixture_id: 'str', locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Play-by-play of a LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) game.

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_pbp to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
fixture_idstrFixture UUID (fixture_id in the schedule).
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_idStringGame UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_idStringSeason UUID of the game.
sequenceInt641-based position of the event in the game (periods in order, events chronological).
event_idStringEvent UUID, shared with the same event in atrium_shots.
period_idInt64Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clockStringTime REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_secondsInt64Seconds remaining in the period, parsed from clock.
entity_idStringTeam UUID the event is credited to.
sideStringSide of the game the row belongs to: home or away (from the fixture's isHome flag).
person_idStringPlayer UUID; null for team events (time-outs, team rebounds).
person_nameStringPlayer the event is credited to; null for team events (time-outs, team rebounds).
bibStringJersey number of the player, as text; null for team events.
event_typeStringEvent type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_typeStringEvent detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
descriptionStringThe event's text in the site's language (e.g. Entre-deux remporte).
successBooleanTrue when a shot or free throw was made, false when missed; null for other events.
success_labelStringThe made / missed label in the site's language; sent on shot events only.
xFloat64Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; null for non-shots.
yFloat64Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified; null for non-shots.
home_scoreInt64Home team's running score after the event.
away_scoreInt64Away team's running score after the event.

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_schedule, lnbp_pbp
games = lnbp_schedule()
lnbp_pbp(fixture_id=games['fixture_id'][0])

lnbp_player_box​

lnbp_player_box(fixture_id: 'str', locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Player box score of a LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) game.

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_box_score to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
fixture_idstrFixture UUID (fixture_id in the schedule).
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_idStringGame UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_idStringSeason UUID of the game.
entity_idStringTeam UUID the player is rostered with for this game.
sideStringSide of the game the row belongs to: home or away (from the fixture's isHome flag).
person_idStringPlayer UUID (person), shared across seasons and sites.
person_nameStringPlayer name as the site prints it (upper case on LNBP and NBL1).
bibStringJersey number the player wears, as text.
positionStringPosition code on the roster (LNB, e.g. PG); null on LNBP.
starterBooleanTrue when the player started the game.
activeBooleanTrue when the player is on the court in a live game.
participatedBooleanTrue when the player entered the game; false rows have null statistics.
did_not_play_reasonStringReason the player did not play; null in every body seen.
minutesStringTime played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (player, this game).
seconds_playedInt64Time played in whole seconds, parsed from minutes (player, this game).
pointsInt64Points scored (player, this game).
reboundsInt64Total rebounds (player, this game).
rebounds_offensiveInt64Offensive rebounds (player, this game).
rebounds_defensiveInt64Defensive rebounds (player, this game).
assistsInt64Assists (player, this game).
stealsInt64Steals (player, this game).
blocksInt64Shots blocked (player, this game).
blocks_receivedInt64Own shots blocked by an opponent (LNB only) (player, this game).
turnoversInt64Turnovers (player, this game).
fouls_totalInt64Fouls committed (player, this game).
fouls_drawnInt64Fouls drawn (committed against the player or team; LNBP only) (player, this game).
plus_minusInt64Plus/minus, the point differential while on court (LNB only; null in some team lines) (player, this game).
efficiencyInt64Efficiency rating, from the site's own formula (player, this game).
field_goals_madeInt64Field goals made, two- and three-pointers together (LNBP only) (player, this game).
field_goals_attemptedInt64Field goals attempted (LNBP only) (player, this game).
field_goals_percentageFloat64Field-goal percentage, 0-100 (LNBP only) (player, this game).
points_two_madeInt64Two-point field goals made (player, this game).
points_two_attemptedInt64Two-point field goals attempted (player, this game).
points_two_percentageFloat64Two-point percentage, 0-100 (player, this game).
points_three_madeInt64Three-point field goals made (player, this game).
points_three_attemptedInt64Three-point field goals attempted (player, this game).
points_three_percentageFloat64Three-point percentage, 0-100 (player, this game).
free_throws_madeInt64Free throws made (player, this game).
free_throws_attemptedInt64Free throws attempted (player, this game).
free_throws_percentageFloat64Free-throw percentage, 0-100 (player, this game).
points_fast_breakInt64Fast-break points (LNBP only) (player, this game).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_schedule, lnbp_player_box
games = lnbp_schedule()
lnbp_player_box(fixture_id=games['fixture_id'][0])

lnbp_schedule​

lnbp_schedule(season: 'Optional[int]' = None, season_id: 'Optional[str]' = None, competition_id: 'Optional[str]' = None, locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Fixtures (schedule and results) of a LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) season.

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_fixtures to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneSeason END year (see the season rule above). Omit season and season_id for the site's current season.
season_idOptional[str]NoneSeason UUID (season_id in the seasons listing); skips the END-year lookup.
competition_idOptional[str]NoneCompetition UUID (a site carries many: conferences, cups); needed when several share the season.
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_idStringSeason UUID the page is about (the site's default season when none was asked).
competition_idStringCompetition UUID of the season.
competition_nameStringCompetition name in the site's language, e.g. Betclic ELITE or LIGA CALIENTE.MX LNBP.
season_end_yearInt64Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
fixture_idStringGame UUID (fixture); the key of every game frame and of the fixture_detail routes.
fixture_typeStringKind of game as sent: REGULAR, PLAYOFF, ... (the set is open).
nameStringFixture name as the site prints it (e.g. Paris - Lyon-Villeurbanne); null on LNBP.
roundStringRound of the game as the site words it, e.g. Journee: 30.
round_codeStringRound code; null in every body seen.
poolStringPool the game belongs to; null when the competition has none.
seriesStringPlayoff series the game belongs to as sent (JSON text when an object); null outside a series.
stage_codeStringOpaque 30-hex stage code of the game; null in every body seen.
statusStringStatus code of the game, e.g. CONFIRMED (final), as sent.
status_labelStringStatus of the game as the site words it in its own language (e.g. Termine, Final).
start_time_utcDatetimeScheduled start, naive datetime in UTC (the API sends no offset).
start_time_localDatetimeScheduled start, naive datetime in the venue's local time (timezone gives the zone; no offset sent).
timezoneStringIANA time zone of the venue (e.g. Europe/Paris, Mexico/General) that start_time_local is in.
times_unconfirmedBooleanTrue while the start time is not final.
venueStringName of the arena where the game is played.
venue_idStringVenue UUID; joins no other route.
attendanceInt64Spectators at the game; null when not reported.
home_entity_idStringTeam UUID of the home team.
home_codeStringShort code of the home team (e.g. PAB).
home_nameStringName of the home team.
home_scoreInt64Points scored by the home team (the API sends a string; Int64 here).
home_result_placeInt64Result place of the home team: 1 for the winner, 2 for the loser.
home_result_statusStringResult status of the home team's score, e.g. CONFIRMED.
home_drawBooleanTrue when the game ended level for the home team.
home_shootout_attemptsStringShootout attempts of the home team as sent (an empty string becomes null).
home_secondary_scoreStringSecondary score of the home team (unused in the samples; shown as text).
away_entity_idStringTeam UUID of the away team.
away_codeStringShort code of the away team (e.g. PAB).
away_nameStringName of the away team.
away_scoreInt64Points scored by the away team (the API sends a string; Int64 here).
away_result_placeInt64Result place of the away team: 1 for the winner, 2 for the loser.
away_result_statusStringResult status of the away team's score, e.g. CONFIRMED.
away_drawBooleanTrue when the game ended level for the away team.
away_shootout_attemptsStringShootout attempts of the away team as sent (an empty string becomes null).
away_secondary_scoreStringSecondary score of the away team (unused in the samples; shown as text).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_schedule
lnbp_schedule(season=2026)

lnbp_seasons​

lnbp_seasons(locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Every season and competition id of LNBP (Mexico, with COPA VALUE and LNBP FEMENIL).

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_seasons to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_idStringSeason UUID; pass it as season_id to any season-scoped wrapper.
competition_idStringCompetition UUID; pass it as competition_id to pick one of several seasons of an END year.
competition_nameStringCompetition name in the site's language; the same name can appear for several years.
season_nameStringSeason name in the site's language, e.g. Betclic ELITE 2025.
abbreviation_localStringLocal abbreviation of the season; null in every body seen.
yearInt64The site's own year of the season: the START year on LNB (site 12), the calendar year elsewhere.
season_end_yearInt64Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
is_default_seasonBooleanTrue for the season the body is about (the site's default when none was asked).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_seasons
lnbp_seasons()

lnbp_shots​

lnbp_shots(fixture_id: 'str', locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Shot chart of a LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) game.

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_shots to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
fixture_idstrFixture UUID (fixture_id in the schedule).
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_idStringGame UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_idStringSeason UUID of the game.
sequenceInt641-based position of the shot among the shots of the game (not the pbp sequence).
event_idStringEvent UUID of the shot; the same event in atrium_pbp.
period_idInt64Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clockStringTime REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_secondsInt64Seconds remaining in the period, parsed from clock.
entity_idStringTeam UUID the event is credited to.
sideStringSide of the game the row belongs to: home or away (from the fixture's isHome flag).
person_idStringPlayer UUID of the shooter.
person_nameStringName of the shooter.
bibStringJersey number of the player, as text; null for team events.
event_typeStringEvent type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_typeStringEvent detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
descriptionStringThe event's text in the site's language (e.g. Entre-deux remporte).
successBooleanTrue when the shot was made, false when missed.
success_labelStringThe made / missed label in the site's language; sent on shot events only.
xFloat64Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; LNBP and NBL1 clamp rim attempts to 5 / 95.
yFloat64Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified.
home_scoreInt64Home team's running score after the event.
away_scoreInt64Away team's running score after the event.

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_schedule, lnbp_shots
games = lnbp_schedule()
lnbp_shots(fixture_id=games['fixture_id'][0])

lnbp_standings​

lnbp_standings(season: 'Optional[int]' = None, season_id: 'Optional[str]' = None, competition_id: 'Optional[str]' = None, locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Standings of a LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) season.

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_standings to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneSeason END year (see the season rule above). Omit season and season_id for the site's current season.
season_idOptional[str]NoneSeason UUID (season_id in the seasons listing); skips the END-year lookup.
competition_idOptional[str]NoneCompetition UUID (a site carries many: conferences, cups); needed when several share the season.
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_idStringSeason UUID of the table.
season_end_yearInt64Season END year (the sdv key): the site's year + 1 on LNB (site 12), the calendar year on the other registered sites; null when the site is unregistered, lists no seasons or the body has no season list.
groupStringLabel of the table when the standings hold several groups; null for a single table.
positionInt64League table position (1 = first).
entity_idStringTeam UUID of the row.
team_nameStringTeam name as the site prints it.
is_current_teamBooleanTrue for the team the page was opened for (team context); false on a plain standings request.
logo_urlStringURL of the team logo image.
winsInt64Games won; -1 for two teams in the 2025-26 LNB table (an administrative ranking, unverified), kept as sent (team, this table).
lossesInt64Games lost (team, this table).
playedInt64Games played (LNBP and the compact standings) (team, this table).
standing_pointsInt64League table points (LNBP) (team, this table).
win_percentageFloat64Share of games won as a 0-1 fraction (not 0-100) (team, this table).
scored_forInt64Points scored over the season (team, this table).
scored_againstInt64Points conceded over the season (team, this table).
point_differenceInt64Point differential over the season (team, this table).
result_string_homeStringHome results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_homeInt64Points scored in home games (team, this table).
scored_against_homeInt64Points conceded in home games (team, this table).
point_difference_homeInt64Point differential in home games (team, this table).
result_string_awayStringAway results as a string of result letters in the site's language, one per game (order and letters per locale; unverified) (team, this table).
scored_for_awayInt64Points scored in away games (team, this table).
scored_against_awayInt64Points conceded in away games (team, this table).
point_difference_awayInt64Point differential in away games (team, this table).
streakInt64Length of the current run of results (the win / loss sign convention is unverified) (team, this table).
streak_homeInt64Length of the current run of home results (sign convention unverified) (team, this table).
streak_awayInt64Length of the current run of away results (sign convention unverified) (team, this table).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_standings
lnbp_standings(season=2026)

lnbp_team_box​

lnbp_team_box(fixture_id: 'str', locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Team box score of a LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) game.

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_team_box_score to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
fixture_idstrFixture UUID (fixture_id in the schedule).
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_idStringGame UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_idStringSeason UUID of the game.
entity_idStringTeam UUID (from the fixture's isHome flag).
sideStringSide of the game the row belongs to: home or away (from the fixture's isHome flag).
minutesStringTime played as an ISO 8601 duration (PT7M23S); a team's is the sum over its players (PT200M) (team, this game).
seconds_playedInt64Time played in whole seconds, parsed from minutes (team, this game).
pointsInt64Points scored (team, this game).
reboundsInt64Total rebounds (team, this game).
rebounds_offensiveInt64Offensive rebounds (team, this game).
rebounds_defensiveInt64Defensive rebounds (team, this game).
assistsInt64Assists (team, this game).
stealsInt64Steals (team, this game).
blocksInt64Shots blocked (team, this game).
blocks_receivedInt64Own shots blocked by an opponent (LNB only) (team, this game).
turnoversInt64Turnovers (team, this game).
fouls_totalInt64Fouls committed (team, this game).
fouls_drawnInt64Fouls drawn (committed against the player or team; LNBP only) (team, this game).
plus_minusInt64Plus/minus, the point differential while on court (LNB only; null in some team lines) (team, this game).
efficiencyInt64Efficiency rating, from the site's own formula (team, this game).
field_goals_madeInt64Field goals made, two- and three-pointers together (LNBP only) (team, this game).
field_goals_attemptedInt64Field goals attempted (LNBP only) (team, this game).
field_goals_percentageFloat64Field-goal percentage, 0-100 (LNBP only) (team, this game).
points_two_madeInt64Two-point field goals made (team, this game).
points_two_attemptedInt64Two-point field goals attempted (team, this game).
points_two_percentageFloat64Two-point percentage, 0-100 (team, this game).
points_three_madeInt64Three-point field goals made (team, this game).
points_three_attemptedInt64Three-point field goals attempted (team, this game).
points_three_percentageFloat64Three-point percentage, 0-100 (team, this game).
free_throws_madeInt64Free throws made (team, this game).
free_throws_attemptedInt64Free throws attempted (team, this game).
free_throws_percentageFloat64Free-throw percentage, 0-100 (team, this game).
points_fast_breakInt64Fast-break points (LNBP only) (team, this game).
extra_fouls_totalInt64Fouls committed (team, credited to the team rather than a player).
extra_reboundsInt64Total rebounds (team, credited to the team rather than a player).
extra_rebounds_defensiveInt64Defensive rebounds (team, credited to the team rather than a player).
extra_rebounds_offensiveInt64Offensive rebounds (team, credited to the team rather than a player).
extra_turnoversInt64Turnovers (team, credited to the team rather than a player).
total_biggest_leadInt64Biggest lead of the game, in points (team, game total).
total_biggest_scoring_runInt64Longest unanswered scoring run of the game, in points (team, game total).
total_field_goals_percentageFloat64Field-goal percentage, 0-100 (LNBP only) (team, game total).
total_free_throws_percentageFloat64Free-throw percentage, 0-100 (team, game total).
total_lead_changesInt64Number of lead changes in the game (team, game total).
total_points_fast_breakInt64Fast-break points (LNBP only) (team, game total).
total_points_from_benchInt64Points scored by non-starters (LNBP only) (team, game total).
total_points_from_turnoverInt64Points scored off opponent turnovers (LNBP only) (team, game total).
total_time_in_leadStringTime the team led, as an ISO 8601 duration (PT36M11S) (team, game total).
total_time_in_lead_secondsInt64Time the team led, in whole seconds (team, game total).
total_turnoversInt64Turnovers (team, game total).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_schedule, lnbp_team_box
games = lnbp_schedule()
lnbp_team_box(fixture_id=games['fixture_id'][0])

lnbp_teams​

lnbp_teams(season: 'Optional[int]' = None, season_id: 'Optional[str]' = None, competition_id: 'Optional[str]' = None, locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Teams of a LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) season.

LNBP (Mexico, with COPA VALUE and LNBP FEMENIL) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_teams to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
seasonOptional[int]NoneSeason END year (see the season rule above). Omit season and season_id for the site's current season.
season_idOptional[str]NoneSeason UUID (season_id in the seasons listing); skips the END-year lookup.
competition_idOptional[str]NoneCompetition UUID (a site carries many: conferences, cups); needed when several share the season.
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
season_idStringSeason UUID of the team list.
entity_idStringTeam UUID (entity): one id per club across seasons, shared by every site that shows the team.
nameStringTeam name in the site's language.
image_urlStringURL of the Sportradar-hosted image (400 px).

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lnbp_teams
lnbp_teams(season=2026)

lpb_pbp​

lpb_pbp(fixture_id: 'str', locale: 'Optional[str]' = None, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> 'Union[pl.DataFrame, pd.DataFrame, Dict]'

Play-by-play of a LPB / LPBF Liga Profesional de Baloncesto (Panama) game.

LPB / LPBF Liga Profesional de Baloncesto (Panama) (men's and women's); season rule: calendar year.

Convenience wrapper: a thin binding of atrium_pbp to this competition, minted from the competition registry (tools/codegen/basketball_competitions.yaml).

Read before use: Unofficial: this is the public endpoint the Sportradar Atrium / Synergy Connect widget calls from every visitor's browser (keyless; the host has no robots.txt). The data is Sportradar's and the leagues'. The wrappers read it on the caller's behalf, one request at least 1 s after the last, and never republish it as release assets. Keep crawls small and incremental. Women's competition data: flagged for the wehoop mirror (Phase C).

Parameters

ParameterTypeDefaultDescription
fixture_idstrFixture UUID (fixture_id in the schedule).
localeOptional[str]NoneLabel locale, e.g. en-EN; omitted = the site's own language.
return_parsedboolTrueparse into a polars DataFrame (default True); False returns the raw body.
return_as_pandasboolFalsewith return_parsed, return a pandas DataFrame instead of polars.

Returns

A polars/pandas DataFrame by default; the raw JSON Dict when return_parsed=False.

col_nametypedescription
website_idInt64Site config id the body came from (12 LNB, 14 LNBP, 3 NBL1, 13 El Salvador, 22 Panama, 236 Austria, 326 Montenegro), read from the body's links.self.
fixture_idStringGame UUID (fixture); the key of every game frame and of the fixture_detail routes.
season_idStringSeason UUID of the game.
sequenceInt641-based position of the event in the game (periods in order, events chronological).
event_idStringEvent UUID, shared with the same event in atrium_shots.
period_idInt64Period number: 1-4 regulation, 11, 12, ... overtimes (not 5).
clockStringTime REMAINING in the period as an ISO 8601 duration (PT10M0S at the start).
clock_secondsInt64Seconds remaining in the period, parsed from clock.
entity_idStringTeam UUID the event is credited to.
sideStringSide of the game the row belongs to: home or away (from the fixture's isHome flag).
person_idStringPlayer UUID; null for team events (time-outs, team rebounds).
person_nameStringPlayer the event is credited to; null for team events (time-outs, team rebounds).
bibStringJersey number of the player, as text; null for team events.
event_typeStringEvent type: 2pt, 3pt, freeThrow, rebound, assist, steal, block, turnover, foul, substitution, timeOut, jumpBall, ... (language-independent).
event_sub_typeStringEvent detail: jumpShot, layup, offensive, defensive, in, out, 1Of2, personal, ...; null when none.
descriptionStringThe event's text in the site's language (e.g. Entre-deux remporte).
successBooleanTrue when a shot or free throw was made, false when missed; null for other events.
success_labelStringThe made / missed label in the site's language; sent on shot events only.
xFloat64Shot location along the 28 m court length as percent of the court (0-100, origin at a corner); the home team attacks the low-x basket all game; null for non-shots.
yFloat64Shot location across the 15 m width as percent of the court (0-100); which sideline is 0 is unverified; null for non-shots.
home_scoreInt64Home team's running score after the event.
away_scoreInt64Away team's running score after the event.

Raises

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist. The site has nothing for the request (no such season, an empty fixture list, a game with no play-by-play yet, an unknown id answered 404, or a fixture id the site does not serve: an unknown id, or a game of another site (the API answers both with an empty fixture)).
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty. Also raised for an error body, a stub, or a body that belongs to another site, type, season, game, player or team than the one asked for.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.

Example

from sportsdataverse.basketball.atrium import lpb_schedule, lpb_pbp
games = lpb_schedule()
lpb_pbp(fixture_id=games['fixture_id'][0])