VLRdevAPI

Team Transactions

Fetch roster transaction history - player joins, leaves, and inactive status changes with dates and context.

team.transactions(team_id) returns the roster transaction history for a team on vlr.gg.

Signature

team.transactions(team_id: int) -> TeamTransactions

Parameters

Prop

Type

Returns - TeamTransactions

Prop

Type

TeamTransaction Fields

Prop

Type

TransactionPlayer Fields

Prop

Type

Examples

Recent transactions

Print the most recent roster transactions.

import vlrdevapi

history = vlrdevapi.team.transactions(team_id=2593)
print(f"Transaction history for team {history.team_id}:")
for t in history.transactions[:10]:
    print(f"  {t.date}: {t.player.ign} {t.action.value} ({t.position})")

Joins vs leaves

Count joins, leaves, and inactive transactions.

import vlrdevapi
from collections import Counter

history = vlrdevapi.team.transactions(team_id=2593)
counts = Counter(t.action.value for t in history.transactions)
print(f"Joins: {counts.get('Join', 0)}")
print(f"Leaves: {counts.get('Leave', 0)}")
print(f"Inactive: {counts.get('Inactive', 0)}")

Current roster from transactions

By looking at the most recent transactions, you can infer the current roster composition.

import vlrdevapi

history = vlrdevapi.team.transactions(team_id=2593)
current = set()
for t in history.transactions:
    if t.action.value == "Join":
        current.add(t.player.ign)
    elif t.action.value == "Leave":
        current.discard(t.player.ign)
print(f"Current roster inferred from transactions: {sorted(current)}")

Curried access

Access transactions using the curried team() shorthand.

import vlrdevapi

team = vlrdevapi.team(2593)
history = team.transactions()
for t in history.transactions[:5]:
    print(f"{t.date}: {t.player.ign} -> {t.action.value}")

Last updated on

On this page