VlrDevApi

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

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

Monitor live matches (skeleton)
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

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 None for TBD/unknown teams

The function never raises exceptions, making it safe to use without try-catch blocks.

Source

Data scraped from: https://www.vlr.gg/matches