Skip to contents

NBL Rosetta Standings

Source: R/nbl_rosetta.R
nbl_rosetta_standings.Rd

Regular-season ladder: position, record, points for and against, home and away splits and form.

Endpoint: GET https://prod.rosetta.nbl.com.au/get/{org}/standings/{season}/regular

Usage

nbl_rosetta_standings(season, org = "wnbl", limit = NULL)

Arguments

season

(integer required): Season END year (2026 = 2025-26). The runtime maps it to Rosetta's year: the START year for the NBL and WNBL from 1998-99, the calendar year for NBL1 and the NBL / WNBL winter seasons up to 1998. END 1998 and 1999 both read Rosetta year 1998, which holds two seasons; the matches frame keeps the one asked for.

org

(character default "wnbl", the women's WNBL): Organisation: nbl (men's NBL), wnbl (women's) or nbl1 (the second tier, men's and women's conferences). One of "nbl", "wnbl", "nbl1".

limit

(integer default NULL): Rows to return. Omitted = a page large enough for the whole list (a short page cut by Rosetta's path cache is refused).

Value

A wehoop_data tibble (one row per ladder entry):

col_nametypedescription
orgcharacterOrganisation the row belongs to: nbl, wnbl or nbl1. From the row's competition, else from the request.
rosetta_standing_idcharacterRosetta's id of this ladder row (UUID v4); not an entity id.
positionintegerLadder position (1 = top)
wonintegerWins in the season.
lostintegerLosses in the season.
playedintegerGames played in the season (wins plus losses).
points_percentagedoublepoints_for / points_against, a RATIO (1.1379 = 113.79 %)
win_percentagedoubleWon / played, a 0-1 FRACTION.
last_5characterResults string, W/L oldest first. Despite the name it can hold the whole season (33 characters in NBL 2025-26)
streakintegerCurrent streak length (the type is the last letter of last_5)
points_forintegerPoints scored by the team in the season.
points_againstintegerPoints conceded.
away_lossesintegerAway losses in the season.
away_winsintegerAway wins in the season.
home_lossesintegerHome losses in the season.
home_winsintegerHome wins in the season.
team_idcharacterDataCore id (UUID v1, Sportradar) of the team; stable across seasons and the id to join on across routes.
rosetta_team_idcharacterRosetta's own id (UUID v4; v5 on NBL1) of the team; routes that take this entity accept it as well as the DataCore id.
team_codecharacterTeam code, e.g. PER (the {team_code} path value)
team_namecharacterName of the team as Rosetta spells it, e.g. Perth Wildcats.
season_yearintegerRosetta's year of the season: the START year for the NBL and WNBL from 1998-99 (2025 = 2025-26), the calendar year for NBL1 and the 1979-1997 winter seasons. See season_end_year for the sdv key.
season_typecharacterSeason type: regular (includes finals), preseason, in_season (cups, blitz, exhibition), test.
season_competition_divisioncharacterNBL1 divisions (conference x gender); empty for NBL and WNBL.
season_end_yearintegersdv season key: the END year of the season (2026 = 2025-26), derived from season_year (a START year for the NBL and WNBL from 1998-99, a calendar year for NBL1 and the 1979-1997 winter seasons; year 1998 is split on the start date). Where the body carries no year it is the season asked for.

Columns the body adds beyond these follow, in body order (sdv-py keeps them too).

Details

  • Unofficial: the JSON proxy behind nbl.com.au (not an API the NBL documents or supports). The terms of use were not reviewed; payloads are not redistributed as release assets.

  • Gated by a referer, not a key: every request carries Origin / Referer set to nbl.com.au (the runtime sends them); without them the host answers 403 MISSING_API_KEY, which is raised as wehoop_asset_fetch.

  • Fills a hole in ESPN: ESPN's nbl feed has box scores but no plays for the 2025-26 NBL season (the stats provider changed from Genius Sports to Sportradar DataCore that year). nbl_rosetta_match_pbp has the full event log with shot x/y for 2025-26 and, in the same shape, back to 2011-12 (WNBL about 2014-15). Matches from 1979 have box scores only.

  • One host serves three organisations; pass org='nbl' (default), 'wnbl' or 'nbl1'. NBL1 is the second tier (men's and women's conferences, calendar-year seasons).

  • Season = the END year (2026 = 2025-26) everywhere. Rosetta's own year is the START year for the NBL and WNBL from 1998-99 and a calendar year for NBL1 and the 1979-1997 winter seasons; the runtime maps it. Year 1998 holds two seasons (calendar 1998 and 1998-99).

  • Ids: <entity>id columns are DataCore ids (UUID v1; join on them), rosetta<entity>_id Rosetta's own. match_id is the DataCore fixture id every match route is keyed on.

  • Unknown ids, orgs and types answer 200 with no rows (wehoop_no_data). Rosetta caches a body per path and serves it whatever the query string, so a page cut by someone else's limit is refused (wehoop_asset_fetch); retry after the cache entry expires.

Errors: wehoop_no_data when Rosetta answers 404 or no rows (an unknown match, team, player or season id, an org or season type with nothing, or no season in progress); wehoop_asset_fetch for the 403 gate body, a stub or error envelope, a page cut by Rosetta's path cache, a body for another org, season or entity than the one asked for, or any other failed fetch; wehoop_bad_request for an unknown org / season_type, a malformed id, or HTTP 400 / 422.

See also

Other NBL Rosetta Functions: nbl_rosetta_match(), nbl_rosetta_match_by_id(), nbl_rosetta_match_pbp(), nbl_rosetta_match_player_box(), nbl_rosetta_match_player_period_box(), nbl_rosetta_match_team_box(), nbl_rosetta_matches(), nbl_rosetta_next_match(), nbl_rosetta_next_match_team(), nbl_rosetta_next_matches(), nbl_rosetta_outcomes(), nbl_rosetta_player_game_log(), nbl_rosetta_player_stats(), nbl_rosetta_players(), nbl_rosetta_seasons(), nbl_rosetta_seasons_current(), nbl_rosetta_stats_leaders(), nbl_rosetta_team_players(), nbl_rosetta_team_stats(), nbl_rosetta_team_stats_leaders(), nbl_rosetta_teams()

Examples

# \donttest{
  try(nbl_rosetta_standings(org = "nbl", season = 2026))
#> ── NBL Rosetta standings from prod.rosetta.nbl.com.au ────────── wehoop 3.1.0 ──
#> ℹ Data updated: 2026-10-22 02:37:14 UTC
#> # A tibble: 10 × 24
#>    org   rosetta_standing_id       position   won  lost played points_percentage
#>    <chr> <chr>                        <int> <int> <int>  <int>             <dbl>
#>  1 nbl   49b90e1d-4806-4142-9e73-…        1    24     9     33             1.14 
#>  2 nbl   469aff8e-afc6-4867-9d5b-…        3    22    11     33             1.09 
#>  3 nbl   f3db1c02-d617-442b-b029-…        4    21    12     33             1.05 
#>  4 nbl   11dc80a4-035b-41e0-b79d-…        2    23    10     33             1.05 
#>  5 nbl   c08140c3-7ce8-4030-b428-…        5    20    13     33             1.05 
#>  6 nbl   0a7b5591-3b70-42f7-a102-…        6    14    19     33             0.996
#>  7 nbl   d923eb2b-1f11-4b4a-8ce6-…        7    13    20     33             0.988
#>  8 nbl   6d5a2929-416e-4885-86d5-…        8    13    20     33             0.959
#>  9 nbl   f57a0e71-c3ff-4acf-b98c-…        9     9    24     33             0.862
#> 10 nbl   d2538239-3147-4ada-a09d-…       10     6    27     33             0.848
#> # ℹ 17 more variables: win_percentage <dbl>, last_5 <chr>, streak <int>,
#> #   points_for <int>, points_against <int>, away_losses <int>, away_wins <int>,
#> #   home_losses <int>, home_wins <int>, team_id <chr>, rosetta_team_id <chr>,
#> #   team_code <chr>, team_name <chr>, season_year <int>, season_type <chr>,
#> #   season_competition_division <chr>, season_end_year <int>
# }