Skip to main content

Sportradar Atrium — additional Python functions — Sportradar Atrium embed API: nbl1_standings–nbl1_teams

nbl1_standings​

nbl1_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 NBL1 (Australia) season.

NBL1 (Australia) (men's and women's); season rule: calendar year, Mar-Aug (END year); conferences are competition_ids.

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 nbl1_standings
nbl1_standings(season=2026)

nbl1_team_box​

nbl1_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 NBL1 (Australia) game.

NBL1 (Australia) (men's and women's); season rule: calendar year, Mar-Aug (END year); conferences are competition_ids.

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 nbl1_schedule, nbl1_team_box
games = nbl1_schedule()
nbl1_team_box(fixture_id=games['fixture_id'][0])

nbl1_teams​

nbl1_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 NBL1 (Australia) season.

NBL1 (Australia) (men's and women's); season rule: calendar year, Mar-Aug (END year); conferences are competition_ids.

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 nbl1_teams
nbl1_teams(season=2026)