Team Placements
Fetch event placement history for a team - placements, prize money, and total winnings across all events.
team.placements(team_id) returns the event placement history for a team on vlr.gg.
Signature
team.placements(team_id: int) -> TeamPlacementsParameters
Prop
Type
Returns - TeamPlacements
Prop
Type
TeamEventPlacement Fields
Prop
Type
EventPlacement Fields
Prop
Type
Examples
All placements
Print all event placements and total winnings.
import vlrdevapi
placements = vlrdevapi.team.placements(team_id=2593)
total = f"{placements.total_winnings_currency}{placements.total_winnings:,}" if placements.total_winnings and placements.total_winnings_currency else "N/A"
print(f"Total winnings: {total}")
print()
for event in placements.placements:
for p in event.placements:
print(f"{event.year} {event.event_name}: {p.placement} in {p.stage}")Best placement per event
Print the best placement achieved in each event.
import vlrdevapi
placements = vlrdevapi.team.placements(team_id=2593)
for event in placements.placements:
best = event.placements[0] if event.placements else None
placement = best.placement if best else "N/A"
print(f"{event.event_name}: {placement}")Total earnings
Print total earnings broken down by year.
import vlrdevapi
placements = vlrdevapi.team.placements(team_id=2593)
total = f"{placements.total_winnings_currency}{placements.total_winnings:,}" if placements.total_winnings and placements.total_winnings_currency else "N/A"
print(f"Total: {total}")
by_year = {}
for event in placements.placements:
by_year[event.year] = by_year.get(event.year, 0) + (event.prize or 0)
currency = placements.total_winnings_currency or "$"
for year in sorted(by_year):
print(f" {year}: {currency}{by_year[year]:,}")Curried access
Access placements using the curried team() shorthand.
import vlrdevapi
team = vlrdevapi.team(2593)
placements = team.placements()
wins = [e for e in placements.placements for p in (e.placements or []) if "1st" in p.placement]
print(f"Tournament wins: {len(wins)}")
for e in wins:
print(f" {e.event_name} ({e.year})")Last updated on