matches.live()
Get live matches (supports optional limit)
Signature
import vlrdevapi as vlr
result = vlr.matches.live(
limit: int | None = None,
timeout: float = 5.0
) -> list[Match]Parameters
Prop
Type
Return Value
Type: list[Match]
Returns a list of live matches. Each Match object contains the same fields as upcoming(), with status == "live".
Prop
Type
Team fields:
Prop
Type
Examples
Get Live Matches
import vlrdevapi as vlr
# Get up to 5 live matches
live_matches = vlr.matches.live(limit=5)
if live_matches:
print(f"LIVE: {len(live_matches)} match(es) in progress")
for m in live_matches:
print(f"{m.event} - {m.event_phase}")
print(f" {m.team1.name} vs {m.team2.name}")
if m.team1.score is not None and m.team2.score is not None:
print(f" Current Score: {m.team1.score}-{m.team2.score}")
else:
print("No live matches currently")Monitor Live Matches
import vlrdevapi as vlr
def get_live_snapshot():
matches = vlr.matches.live()
if matches:
print(f"\n{len(matches)} live match(es):")
for m in matches:
print(f" {m.team1.name} vs {m.team2.name}")
print(f" Event: {m.event}")
else:
print("No live matches")
# Schedule get_live_snapshot() with your preferred scheduler (cron, APScheduler, etc.)Get Live Match Details
import vlrdevapi as vlr
# Get live matches and access detailed info
matches = vlr.matches.live()
for m in matches:
print(f"Match ID: {m.match_id}")
print(f"Event: {m.event} - {m.event_phase}")
print(f"Teams: {m.team1.name} vs {m.team2.name}")
# Get team IDs if available
if m.team1.id and m.team2.id:
print(f"Team IDs: {m.team1.id} vs {m.team2.id}")
# Get detailed match info using series.info()
# series_info = vlr.series.info(m.match_id)Error Handling
- Network failures: Returns an empty list
[] - No live matches: Returns an empty list
[] - Team IDs: Can be
Nonefor TBD/unknown teams
The function never raises exceptions, making it safe to use without try-catch blocks.
Related
Source
Data scraped from: https://www.vlr.gg/matches