VLRdevAPI

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) -> TeamPlacements

Parameters

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

On this page