players

One row per canonical player. The id is the UUID the datasets carry in their *_player_ids columns (player props name their subjects by id, never by name) and the value the player_id filter on betflux get matches.

Fetching

curl -s "https://api.betflux.ai/v1/players?league=NBA&team_id=<team-uuid>" \
  -H "Authorization: Bearer $BETFLUX_API_KEY"

betflux players --league NBA --team-id <team-uuid>

players = bf.players(league="NBA", team_id="<team-uuid>")

Parameter	Meaning
league	Restrict to one league code
team_id	Only players whose current team is this UUID
limit, cursor	Pagination

Sorted by league, then last name. Rosters are current state: current_team_id moves with trades and is_active drops when a player leaves the league, but historical dataset rows keep the id they were written with.

Columns

Column	Type	Nullable	Description
id	string	no	Canonical player UUID (matches closing-lines `*_player_ids` and the `player_id` filter).
league	string	no	League code the player belongs to.
first_name	string	no	First name.
last_name	string	no	Last name.
position	string	yes	Position code, e.g. PG, QB; null when unknown.
jersey_number	integer	yes	Current jersey number; null when unknown.
current_team_id	string	yes	UUID of the player's current team; null for free agents.
is_active	boolean	no	False once the player is out of the league.