Get the shot chart of one game from the live API: one row per made / missed
field goal and per made free throw, with coord_x / coord_y in centimeters
from the hoop.
Endpoint: GET https://live.euroleague.net/api/Points?gamecode={game_code}&seasoncode={season_code}
Points is the shot-chart source: one row per field-goal attempt
(id_action 2FGM / 2FGA / 3FGM / 3FGA) and per made free throw
(FTM), with coord_x / coord_y, zone, the fastbreak /
second_chance / points_off_turnover flags, the running score
(points_a / points_b), minute, the game clock (console) and a utc
timestamp. Team A is the home side as measured on one game.
Arguments
- game_code
(integer required): Game number within the season (1-based; the
game_codecolumn ofeuroleague_games()).- season_code
(character required): Competition code + start year:
E2025(EuroLeague 2025-26),U2025(EuroCup).
Value
A hoopR_data tibble with one row per shot.
Its columns are listed in return_columns
(subset(return_columns, fn == "euroleague_game_points")) and in the searchable
return columns article.
Details
Unofficial, keyless API, not supported by Euroleague Basketball; hoopR only
wraps it. This
function mirrors sportsdataverse-py's euroleague_game_points(): same arguments,
defaults and snake_case columns, one row per sportsdataverse-py row.
Coordinate frame, as measured in the reference capture (E2025 game 1, 158 rows; U2025 game 1, 176 rows):
Units: integer centimeters. Origin: the hoop. 2FG radii run 8-512 cm, 3FG radii 722-925 cm (the FIBA arc is 675 cm), zone
A(rim) sits at radius 8-33 cm.Both teams are mapped onto one basket;
coord_ygrows away from the baseline toward the court (-6 to 865 cm for every team on the E game, -69 to 1028 on the U game; 3FG rows sit at y 414-865). Negative y is behind the hoop (the U game has a few rows up to 69 cm behind it, i.e. under or behind the backboard).coord_xis signed left / right of the hoop (-683 to 696 cm); 3-point zoneHis x < 0 andIis x > 0. Which sideline is positive (from the shooter's view or from the scorer's table) is UNVERIFIED from the data alone.Free throws are not located:
FTMrows carrycoord_x = coord_y = -1andzone = ""(a sentinel, not a spot 1 cm from the hoop). Filter them out before plotting.zoneletters A-I: A rim, B / C close left / right, D / E mid, F / G long two, H / I three.
The live API's codes are space-padded fixed-width strings
(TEAM = "IST "); every string cell is stripped. Its "no such game"
answer is an empty 200 body, returned as a zero-row tibble with the
documented columns (not an error). A 404 raises hoopR_no_data, a 400 / 422
hoopR_invalid_request, any other failure hoopR_fetch_error (all inherit
hoopR_error).
See also
family_euroleague lists every function in this family.
Examples
# \donttest{
try({
shots <- euroleague_game_points(game_code = 1, season_code = "E2025")
shots[shots$id_action != "FTM", c("team", "id_action", "coord_x", "coord_y", "zone")]
})
#> ── EuroLeague game points (shot chart) from live.euroleague.net ────────────────
#> ℹ Data updated: 2026-11-13 21:12:58 UTC
#> # A tibble: 131 × 5
#> team id_action coord_x coord_y zone
#> <chr> <chr> <int> <int> <chr>
#> 1 IST 2FGM -12 -6 A
#> 2 IST 3FGA 414 602 I
#> 3 IST 2FGM -307 0 D
#> 4 TEL 2FGM -81 125 B
#> 5 IST 3FGM 125 759 I
#> 6 TEL 2FGM 0 351 D
#> 7 IST 2FGM 31 94 C
#> 8 TEL 2FGA -382 319 F
#> 9 TEL 2FGM -119 87 B
#> 10 IST 3FGA -514 577 H
#> # ℹ 121 more rows
# }
