VlrDevApi

events.standings()

Get event standings and prize distribution

Signature

import vlrdevapi as vlr

result = vlr.events.standings(
    event_id: int,
    stage: str | None = None,
    timeout: float = 5.0
) -> Standings | None

Parameters

Prop

Type

Return Value

Type: Standings | None

Returns event standings with prize distribution or None if not found.

Prop

Type

StandingEntry fields:

Prop

Type

Examples

Get Event Standings

Get event standings
import vlrdevapi as vlr

# Get standings for an event (all stages)
standings = vlr.events.standings(event_id=2498)

if standings:
    print(f"Prize Distribution - {len(standings.entries)} teams")
    print(f"URL: {standings.url}\n")
    
    for entry in standings.entries:
        place = entry.place
        team = entry.team_name or "TBD"
        prize = entry.prize or "No prize"
        
        print(f"{place}. {team}")
        print(f"   Prize: {prize}")
        
        if entry.team_country:
            print(f"   Country: {entry.team_country}")
        if entry.note:
            print(f"   Note: {entry.note}")
else:
    print("Standings not available for this event")

Filter by Stage

Filter standings by stage
import vlrdevapi as vlr

# Discover available stage names (case-insensitive)
stages = vlr.events.stages(event_id=2498)
stage_names = [stage.name for stage in stages]
print("Available stages:", stage_names)

# Fetch only the Playoffs standings
standings = vlr.events.standings(event_id=2498, stage="Playoffs")

if standings:
    print(f"Source: {standings.url}")
    for entry in standings.entries[:5]:
        print(f"{entry.place}: {entry.team_name} - {entry.prize or 'N/A'}")
else:
    print("Standings unavailable for the requested stage")

Error Handling

  • Network failures: Returns None
  • Invalid event ID: Returns None
  • No standings available: Returns None

Always check if the return value is not None before accessing properties.

Source

Data scraped from: https://www.vlr.gg/event/{event_id}/prize-distribution