Series Rounds
Fetch round-by-round data for a specific game within a series - winner, win type, side, score progression, and per-round economy (bank, spend, buy tiers).
series.rounds(series_id, game_id) returns round-by-round data for a specific game within a series, including the per-round economy (bank, spend, buy tier) merged from the economy tab.
Signature
series.rounds(
series_id: int,
game_id: int,
) -> RoundsDataWith curried access:
vlrdevapi.series(series_id).rounds(game_id: int) -> RoundsDataParameters
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, the side they were playing, and how much money each team had. 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.full_name}) on {rd.side}")
print(f" Score: {rd.team1_score} - {rd.team2_score}")
print(f" Buy: {rd.buy_type_team1} vs {rd.buy_type_team2} - bank {rd.bank_team1}/{rd.bank_team2}")Round economy timeline
The economy tab's per-round money data (bank, spend, buy tier) is merged into the same round records, so the round timeline is the single source for round-by-round analysis.
import vlrdevapi
rounds = vlrdevapi.series.rounds(series_id=670471, game_id=1)
print("Round | Buy 1 vs Buy 2 | Spent 1 vs Spent 2 | Winner")
for rd in rounds.rounds:
print(f"R{rd.round_number:>2} | {rd.buy_type_team1} vs {rd.buy_type_team2:<8} | {rd.spent_team1} vs {rd.spent_team2} | {rd.winner_team_name}")Win type breakdown
Analyse how each team won their rounds - by elimination, spike detonation, defuse, or time expiry.
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.full_name for r in team1_wins)}")
print(f"{rounds.team2}: {Counter(r.win_type.full_name 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 pistol rounds.
import vlrdevapi
series = vlrdevapi.series(670471)
rounds = series.rounds(game_id=1)
pistol_rounds = [r for r in rounds.rounds if r.is_pistol_round]
for rd in pistol_rounds:
print(f"Pistol R{rd.round_number}: won by {rd.winner_team_name}")Last updated on