supercoach_players
Get a complete snapshot for every player in a round: price, projection, averages, ownership, positions, news, and upcoming matchups. Pass round and sport to retrieve forward-looking data.
Instructions
THE feed — every player's full snapshot for one round: price + price_change, avg/avg3/avg5, the ppts1 projection, owned %, positions, availability, dated news and the next-three-opponents matchup context. LARGE (~1–3 MB; 174–1032 players depending on sport). Pass round (from supercoach_settings.next_round) for a forward snapshot; loop round=1..current_round with embed=player_match_stats to build a per-round score series. The embed set is CLOSED — only positions, player_stats, player_match_stats, notes, odds add data (anything else is ignored).
Returns: array of {id, first_name, last_name, team:{name, abbrev}, team_id, played_status:{status}, injury_suspension_status_text, positions:[{position, position_long}], notes:[{note, created_on}], player_stats:[{price, price_change, total_price_change, avg, avg3, avg5, ppts1, ppts, owned, total_games, total_points, opp:{abbrev}, opph, oppavg, ven:{name}, venavg, opp1, opp2, opp3, total_<sport stats…>}], player_match_stats:[{games, points}]} — USE ppts1 (real projection, ≈avg, present for afl/nrl; falls back to avg when absent, e.g. nba). AVOID ppts (erratic). In mode=draft each player also carries top-level predraft_rank + player_stats.position_ranks. LARGE.
Example: AFL round-16 forward snapshot (price + projection + matchup)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | classic | |
| year | Yes | ||
| embed | No | positions,player_stats,notes | |
| round | No | ||
| sport | Yes |