Skip to contents

Get ESPN NBA Transactions

Get ESPN NBA Transactions

Usage

espn_nba_transactions(season = most_recent_nba_season(), limit = 100, ...)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.

limit

Maximum number of transactions to return (integer). Default 100.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...).

Value

A hoopR_data tibble with one row per transaction:

col_nametypesdescription
transaction_idcharacter
datecharacterDate in YYYY-MM-DD format.
typecharacterRecord type / category.
descriptioncharacterLong-form description text.
team_idcharacterUnique team identifier.
athlete_idcharacterUnique athlete identifier (ESPN).
athlete_namecharacterAthlete display name (ESPN).
from_team_idcharacter
to_team_idcharacter

Details

Calls the ESPN site-v2 endpoint https://site.api.espn.com/apis/site/v2/sports/basketball/nba/transactions?season={year}&limit={limit}. Releases have a NULL to_team_id; those are stored as NA. Returns an empty tibble rather than erroring when no transactions are available.

See also

Other ESPN NBA Functions: espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp(), espn_nba_draft_pick(), espn_nba_freeagents(), espn_nba_player_contracts(), espn_nba_team_depthchart()

Author

Saiem Gilani

Examples

# \donttest{
  espn_nba_transactions(season = 2025, limit = 10)
#> ── ESPN NBA Transactions from ESPN.com ────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:47:48 UTC
#> # A tibble: 10 × 9
#>    transaction_id date         type  description team_id athlete_id athlete_name
#>    <chr>          <chr>        <chr> <chr>       <chr>   <chr>      <chr>       
#>  1 NA             2025-12-31T… NA    Signed G R… 1       NA         NA          
#>  2 NA             2025-12-29T… NA    Signed C M… 28      NA         NA          
#>  3 NA             2025-12-26T… NA    Signed F M… 20      NA         NA          
#>  4 NA             2025-12-26T… NA    Signed C M… 11      NA         NA          
#>  5 NA             2025-12-24T… NA    Signed C P… 30      NA         NA          
#>  6 NA             2025-12-24T… NA    Waived G H… 20      NA         NA          
#>  7 NA             2025-12-23T… NA    Waived F D… 30      NA         NA          
#>  8 NA             2025-12-23T… NA    Signed C M… 1       NA         NA          
#>  9 NA             2025-12-22T… NA    Signed C C… 29      NA         NA          
#> 10 NA             2025-12-20T… NA    Signed C J… 11      NA         NA          
#> # ℹ 2 more variables: from_team_id <chr>, to_team_id <chr>
# }