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 | NoneParameters
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
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
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.
Related
events.info()
Get event header information
events.matches()
Get event matches
teams.info()
Get detailed team information
Source
Data scraped from: https://www.vlr.gg/event/{event_id}/prize-distribution