Series Rounds

Fetch round-by-round data for a specific game within a series - winner, win type, side, and score progression.

series.rounds(series_id, game_id) returns round-by-round data for a specific game within a series.

Signature

series.rounds(
    series_id: int,
    game_id: int,
) -> RoundsData

With curried access:

vlrdevapi.series(series_id).rounds(game_id: int) -> RoundsData

Parameters

Prop

Type

Returns - `RoundsData`

Prop

Type

`RoundData` Fields

Prop

Type

Examples

Basic round data

Fetch every round in a game, showing the winner, win type, and the side they were playing. This is useful for building score progression charts or understanding how the game swung.

import vlrdevapi

rounds = vlrdevapi.series.rounds(series_id=670471, game_id=1)
print(f"{rounds.team1} vs {rounds.team2}")
print(f"Total rounds: {len(rounds.rounds)}")

for rd in rounds.rounds[:5]:
    print(f"R{rd.round_number}: {rd.winner_team_name} won ({rd.win_type}) on {rd.side}")
    print(f"  Score: {rd.team1_score} - {rd.team2_score}")

Win type breakdown

Analyse how each team won their rounds - by elimination, spike detonation, defuse, or timeout.

import vlrdevapi
from collections import Counter

rounds = vlrdevapi.series.rounds(series_id=670471, game_id=1)

team1_wins = [r for r in rounds.rounds if r.winner_team_name == rounds.team1]
team2_wins = [r for r in rounds.rounds if r.winner_team_name == rounds.team2]

print(f"{rounds.team1}: {Counter(r.win_type for r in team1_wins)}")
print(f"{rounds.team2}: {Counter(r.win_type for r in team2_wins)}")

Score progression

Generate a round-by-round score progression for both teams, useful for visualising match momentum.

import vlrdevapi

rounds = vlrdevapi.series.rounds(series_id=670471, game_id=1)
print("Round | Score")
for rd in rounds.rounds:
    print(f"R{rd.round_number:>2}  | {rd.team1_score} - {rd.team2_score}")

Curried access

Use the curried pattern to inspect specific rounds such as pistol rounds.

import vlrdevapi

series = vlrdevapi.series(670471)
rounds = series.rounds(game_id=1)
pistol_rounds = [r for r in rounds.rounds if r.round_number in (1, 13)]
for rd in pistol_rounds:
    print(f"Pistol R{rd.round_number}: won by {rd.winner_team_name}")

On this page