Skip to main content

League of Legends Riot Web Livestats

GAME_EVENT/MATCH/ANNOUNCED_ANCIENT

This message is sent whenever a special monster spawn is announced by the game, currently only the next dragon.
Download

PROPERTIES

dragonType

string, null

The type of dragon that will spawn.

gameTime

integer

The ingame clock's time in milliseconds.

monsterType

string, null

The monster type of the announced spawn, can be `dragon` only at the moment.

spawnGameTime

integer

The ingame clock time when this monster will spawn, in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/END_MAP

This message is sent when a game has ended.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

isMatchOver

boolean, null

Indicates whether with the end of this map one of the teams satisfied the win condition for the match series (e.g. won 2 games in best-of-three match).

matchCurrent

integer

The current game number in the match series.

winningTeamUrn

string, null

The reference URN of the winning team.

EXAMPLE

GAME_EVENT/MATCH/END_PAUSE

This message is sent when the game resumes after a pause.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/EXPIRED_ITEM

An item that was sitting on the ground expired and was deleted, e.g. Eye of Herald. This message is sent when an action on an item is performed.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

item

integer

The item internal ID.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/MATCH/EXPIRED_OBJECTIVE

This message is sent when the turret plating expires after 14 minutes. This value is currently hardcoded and may be invalid in case the game logic changes.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

EXAMPLE

GAME_EVENT/MATCH/SPAWNED_ANCIENT

This message is sent whenever a special monster spawned in the game, e.g. a dragon.
Download

PROPERTIES

dragonType

string, null

The type of dragon in case monster type was `dragon`.

gameTime

integer

The ingame clock's time in milliseconds.

monsterType

string, null

The type of monster that spawned.

EXAMPLE

GAME_EVENT/MATCH/START_MAP

This message is sent when the draft is over and the game starts.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

matchCurrent

integer

The current game number in the match series.

EXAMPLE

GAME_EVENT/MATCH/START_PAUSE

This message is sent when the game is paused for any reason.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

EXAMPLE

GAME_EVENT/PLAYER/CONSUMED_ITEM

An item was consumed or used. This message is sent when an action on an item is performed.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

item

integer

The item internal ID.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/DIED

This message is sent when the death statistic of a champion is incremented.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

playerUrn

string, null

Reference URN of the player who died.

position

array, null

The ingame coordinates where the event happened.

integer

respawnTime

integer

Time in milliseconds until the killed player respawns.

teamUrn

string, null

Reference URN of the player's team.

totalDeaths

integer

Total number of this player's deaths in current game, including this death.

EXAMPLE

GAME_EVENT/PLAYER/KILL

This message is sent when a champion is killed.
Download

PROPERTIES

assistants

array, null

A list of player URNs that assisted the kill.

string

A list of player URNs that assisted the kill.

gameTime

integer

The ingame clock's time in milliseconds.

killerTeamUrn

string, null

The reference URN of the killer's team.

killerUrn

string, null

The reference URN of the killer.

position

array, null

The ingame coordinates where the event happened.

integer

victimTeamUrn

string, null

The reference URN of the victim's team.

victimUrn

string, null

The reference URN of the victim.

EXAMPLE

GAME_EVENT/PLAYER/KILLED_WARD

This message is sent when a ward was destroyed by a champion.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

killerTeamUrn

string, null

Reference URN of the team of the player who destroyed the ward.

killerUrn

string, null

Reference URN of the player who destroyed the ward.

placerTeamUrn

string, null

Reference URN of the team of the player who placed the ward.

placerUrn

string, null

Reference URN of the player who placed the ward.

position

array, null

The ingame coordinates where the event happened.

integer

wardType

string, null

The type of the ward that was destroyed, e.g. control, sight, yellowTrinket.

EXAMPLE

GAME_EVENT/PLAYER/LEVEL_UP

This message is sent when a champion leveled up.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

newValue

integer

The player's hero level after leveling up.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/PICKED_UP_ITEM

An item was picked up from the ground, e.g. Eye of Herald. This message is sent when an action on an item is performed.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

item

integer

The item internal ID.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/PLACED_WARD

This message is sent when a ward was placed by a champion.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

placerTeamUrn

string, null

Reference URN of the team of the player who placed the ward.

placerUrn

string, null

Reference URN of the player who placed the ward.

position

array, null

The ingame coordinates where the event happened.

integer

wardType

string, null

The type of the ward that was placed, e.g. control, sight, yellowTrinket.

EXAMPLE

GAME_EVENT/PLAYER/PURCHASED_ITEM

An item was purchased. This message is sent when an action on an item is performed.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

item

integer

The item internal ID.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/SELECTED_HERO

This message is sent when a player selected a champion during the draft or switched to a new champion during the swapping phase between draft and game start.
Download

PROPERTIES

championId

integer

The ID of the player's new champion.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The player's team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/SKILL_LEVEL_UP

This message is sent when a champion's skill leveled up or was replaced.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

level

integer

The skill's new level.

playerUrn

string, null

The player reference URN.

slot

The skill slot that was leveled up.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/SOLD_ITEM

An item was sold. This message is sent when an action on an item is performed.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

item

integer

The item internal ID.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/SPAWNED

This message is sent when a dead champion whose respawn timer is about to expire/expired has health of more than 0 again.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

playerUrn

string, null

The player reference URN.

position

array, null

The ingame coordinates where the event happened.

integer

teamUrn

string, null

The player's team reference URN.

EXAMPLE

GAME_EVENT/PLAYER/SPECIAL_KILL

This message is sent when a champion accomplishes a special kill, e.g. first blood or a multi-kill.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

killStreak

integer

Number of kills in the player's killing streak.

killType

string, null

Type of the special kill, e.g. multi, ace, firstBlood.

killerTeamUrn

string, null

The reference URN of the killer's team.

killerUrn

string, null

The reference URN of the killer.

position

array, null

The ingame coordinates where the event happened.

integer

EXAMPLE

GAME_EVENT/PLAYER/UNDO_ITEM

An item action was undone, e.g. a purchase or recipe was reverted. This message is sent when an action on an item is performed.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

item

integer

The item internal ID.

playerUrn

string, null

The player reference URN.

teamUrn

string, null

The team reference URN.

EXAMPLE

GAME_EVENT/TEAM/BANNED_HERO

This message is sent when a team banned a champion during the draft.
Download

PROPERTIES

championId

integer

The id of the champion who was banned.

teamUrn

string, null

The reference URN of the team that issued the ban.

EXAMPLE

GAME_EVENT/TEAM/KILLED_ANCIENT

This message is sent whenever a special monster is killed in the game, e.g. a dragon.
Download

PROPERTIES

assistants

array, null

A list of player URNs that assisted killing the monster.

string

A list of player URNs that assisted killing the monster.

dragonType

string, null

The type of dragon that was killed, if the `monsterType` is `dragon`.

gameTime

integer

The ingame clock's time in milliseconds.

killerTeamUrn

string, null

The URN of the team that killed the monster, if available.

killerUrn

string, null

The URN of the player that killed the monster, if available.

monsterType

string, null

The type of monster that was killed. Can be `dragon`, `baron`, `vileMaw`, `riftHerald`, `blueCamp`, `redCamp`, `scuttleCrab`, or other values if new monsters are added to the game.

position

array, null

The ingame coordinates where the event happened.

integer

EXAMPLE

GAME_EVENT/TEAM/TOOK_OBJECTIVE

This message is sent when a team destroyed a building.
Download

PROPERTIES

assistants

array, null

A list of player URNs that assisted destroying the building.

string

A list of player URNs that assisted destroying the building.

buildingTeamUrn

string, null

The URN of the team that the building belonged to, if available.

buildingType

string, null

The type of building that was destroyed, e.g. `turret`.

gameTime

integer

The ingame clock's time in milliseconds.

killerTeamUrn

string, null

The URN of the team that destroyed the building, if available.

killerUrn

string, null

The URN of the player that destroyed the building, if available.

lane

string, null

The lane the building was in.

position

array, null

The ingame coordinates where the event happened.

integer

turretTier

string, null

The tier of the turret, in case the building was a turret.

EXAMPLE

GAME_EVENT/TEAM/UPDATE_SCORE

This message is sent when a team's champion kills, or tower kills statistic is incremented or a team's total gold statistic changed by at least 0.1k (rounded).
Download

PROPERTIES

championsKilled

integer

Number of champions team members killed during this game.

gameTime

integer

The ingame clock's time in milliseconds.

teamUrn

string, null

The team reference URN.

totalGold

integer

Total team members gold balance.

towersKilled

integer

Number of towers team members destroyed during this game.

EXAMPLE

INFO/MATCH/ANNOUNCE

The first message sent for a game, the team and player information might be incomplete at this point. This message contains fixture information about the teams, the players, and the series.
Download

PROPERTIES

fixture

object, null

Fixture information for this match series.

PROPERTIES

esportsId

string, null

references

object, null

Reference IDs of the fixture in external services.

seriesCurrent

integer

Current game (map) number in the match series.

seriesMax

integer

Maximum number of games (maps) in this match series.

seriesType

Type of the match series, e.g. BEST_OF.

startTime

string, null

UTC date and time when the match started.

title

Game title that is being played, e.g. CSGO, DOTA.

urn

string, null

The fixture reference URN.

remade

boolean, null

Indicates whether the game was remade and replaces the previous game instance, only applicable for ANNOUNCE.

teams

array, null

Currently available information about the participating teams and players.

object

Currently available information about the participating teams and players.

PROPERTIES

esportsId

string, null

participants

array, null

List of currently known team participants in this game.

object

List of currently known team participants in this game.

PROPERTIES

championId

integer

The ID of the player's champion.

esportsId

string, null

name

string, null

The player name.

references

object, null

Reference IDs of the player in external services.

summonerName

string, null

urn

string, null

The player reference URN.

references

object, null

Reference IDs of the team in external services.

urn

string, null

The team reference URN.

EXAMPLE

INFO/MATCH/ROLLBACK

This message is sent when the game was reset to an earlier point in time, which might revert some previous events.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

EXAMPLE

INFO/MATCH/UPDATE

Sent when the game starts, with final fixture information for the given game. This message contains fixture information about the teams, the players, and the series.
Download

PROPERTIES

fixture

object, null

Fixture information for this match series.

PROPERTIES

esportsId

string, null

references

object, null

Reference IDs of the fixture in external services.

seriesCurrent

integer

Current game (map) number in the match series.

seriesMax

integer

Maximum number of games (maps) in this match series.

seriesType

Type of the match series, e.g. BEST_OF.

startTime

string, null

UTC date and time when the match started.

title

Game title that is being played, e.g. CSGO, DOTA.

urn

string, null

The fixture reference URN.

remade

boolean, null

Indicates whether the game was remade and replaces the previous game instance, only applicable for ANNOUNCE.

teams

array, null

Currently available information about the participating teams and players.

object

Currently available information about the participating teams and players.

PROPERTIES

esportsId

string, null

participants

array, null

List of currently known team participants in this game.

object

List of currently known team participants in this game.

PROPERTIES

championId

integer

The ID of the player's champion.

esportsId

string, null

name

string, null

The player name.

references

object, null

Reference IDs of the player in external services.

summonerName

string, null

urn

string, null

The player reference URN.

references

object, null

Reference IDs of the team in external services.

urn

string, null

The team reference URN.

EXAMPLE

SNAPSHOT/MATCH/UPDATE

This message is sent every time stats update (max once per second) or when any type of event is received. Match update snapshots are potentially rate-limited to 1 every 5 seconds, depending on the contract.
Download

PROPERTIES

esportsGameID

integer

This field references Riot's esports game ID. This field will be removed in a future release, please refer to RIOT_ESPORTS_ID within 'references'.

gameID

integer

This field will be removed in a future release.

gameMode

string, null

Denotes the mode being played, usually 'CLASSIC'.

gameOver

boolean

Indicates whether the game has ended.

gameState

string, null

This field is passed-through from the game and indicates whether the game is in draft or live. The field will be removed/replaced in a future release.

gameTime

integer

Indicates the time on the ingame clock in milliseconds.

gameVersion

string, null

The League of Legends version for this game.

lastUpdateTime

string, null

The timestamp when the game state was last updated.

name

string, null

This field denotes the game/lobby name, it will be removed in a future release.

paused

boolean

Indicates whether the game is paused.

platformID

string, null

This field will be removed in a future release.

playbackId

integer

This field will be removed in a future release.

references

object, null

A list of external reference IDs for this match, e.g. Riot's esports match ID.

sequenceIndex

integer

This field will be removed in a future release.

seriesStatus

object, null

Information about the current match series.

PROPERTIES

perid

string, null

Match series reference PERID.

seriesCurrent

integer

Current map number in the match series.

seriesMax

integer

Maximum number of maps in this match series.

seriesScores

object, null

Total team scores in this match series.

seriesType

Type of the match series, e.g. BEST_OF.

teamOne

object, null

The current state for the first team in the game (blue).

PROPERTIES

assists

integer

A statistic for kill assists done by players of this team.

baronKills

integer

A statistic for baron kills done by this team in this game.

championsKills

integer

A statistic for champion kills done by this team in this game.

deaths

integer

A statistic counting the champion deaths for this team.

dragonKills

integer

A statistic for dragon kills done by this team in this game.

esportsTeamId

integer

Riot's esports team id. This field will be removed in a future release, please use RIOT_ESPORTS_ID within 'references' instead.

inhibKills

integer

A statistic for inhibitor kills done by this team in this game.

killedDragonTypes

array, null

A list of dragon kills done by this team, will contain e.g. [fire, earth, air].

string

A list of dragon kills done by this team, will contain e.g. [fire, earth, air].

liveDataTeamUrn

string, null

The reference URN used to identify the team across all messages.

players

array, null

A list of players in this team.

object

A list of players in this team.

PROPERTIES

abilityPower

integer

The champion's ability power value.

accountID

integer

The player's account id. This field will be removed in a future release, please use RIOT_ACCOUNT_ID within 'references' instead.

alive

boolean

Indicates whether the player's champion is alive.

armor

integer

The champion's base armor resist value.

armorPenetration

integer

The champion's flat armor penetration value.

armorPenetrationPercent

integer

The champion's percentage armor penetration value.

armorPenetrationPercentBonus

integer

The champion's percentage bonus armor penetration value.

attackDamage

integer

The champion's base attack damage value.

attackSpeed

integer

The champion's base attack speed value.

ccReduction

integer

The champion's current tenacity value in percents.

championID

integer

The player's champion ID.

championName

string, null

The player's champion (internal) name.

cooldownReduction

integer

The champion's ability cooldown reduction value.

currentGold

integer

The champion's current gold balance.

esportsPlayerID

integer

The player's Riot esports player id. This field will be removed in a future release, please use RIOT_ESPORTS_ID within 'references' instead.

esportsTeamID

integer

The player's Riot esports team id. This field will be removed in a future release, please use liveDataTeamUrn to refer to the team instead.

experience

integer

The champion's experience.

goldPerSecond

integer

The champion's gold generation rate.

health

integer

The champion's current health value.

healthMax

integer

The champion's max health value.

healthRegen

integer

The champion's health regeneration value.

items

array, null

A list of player's inventory items.

object

A list of player's inventory items.

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the item cooldown.

itemID

integer

The item internal ID.

purchaseGameTime

integer

The time on ingame clock when the last item of this kind was purchased by the player (milliseconds).

stackSize

integer

Number of items of this kind the player has currently stacked in their inventory.

itemsSold

array, null

Unused. Will be removed in a future release.

object

Unused. Will be removed in a future release.

PROPERTIES

goldGain

integer

itemId

integer

itemsUndo

array, null

Unused. Will be removed in a future release.

object

Unused. Will be removed in a future release.

PROPERTIES

goldGain

integer

itemId

integer

itemIdBeforeUndo

integer

keystoneID

integer

A reference ID to the summoner's keystone, found in 'runesReforged.json' available via Riot's Data Dragon.

level

integer

The champion's level.

lifeSteal

integer

The champion's life steal value.

liveDataPlayerUrn

string, null

The reference URN used to identify the player across all messages.

liveDataTeamUrn

string, null

The player's team reference URN.

magicPenetration

integer

The champion's flat magic penetration value.

magicPenetrationPercent

integer

The champion's percentage magic penetration value.

magicPenetrationPercentBonus

integer

The champion's percentage bonus magic penetration value.

magicResist

integer

The champion's base magic resist value.

participantID

integer

The internal participant slot of the player. This field will be removed in a future release.

pickMode

integer

The player's last pick mode value from the draft.

pickTurn

integer

The player's last pick turn value from the draft.

position

array, null

The current or last known position of the player's champion.

integer

primaryAbilityResource

integer

The champion's current value of the ability resource (mana, energy, etc.).

primaryAbilityResourceMax

integer

The champion's maximum amount of the ability resource (mana, energy, etc.).

primaryAbilityResourceRegen

integer

The champion's current ability resource regen rate.

references

object, null

A list of external reference IDs for this player, e.g. Riot's esports player ID.

respawnTimer

number

Contains the champion's respawn time in seconds if dead.

skills

object, null

The player's champion skills.

spell1

object, null

The player's first chosen summoner spell.

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the spell cooldown.

name

string, null

Summoner spell name.

spell2

object, null

The player's second chosen summoner spell.

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the spell cooldown.

name

string, null

Summoner spell name.

spellVamp

integer

The champion's spell vamp value.

stats

object, null

The player's current match statistics.

PROPERTIES

assists

integer

Number of assists the player performed.

championsKilled

integer

Total number of other team's champions this player killed.

magicDamageDealtChampions

number

Amount of magic damage the player dealt to the enemy champions.

magicDamageDealtPlayer

number

Amount of magic damage the player dealt.

magicDamageTaken

number

Amount of magic damage the player had taken during the game.

minionsKilled

number

Total number of other team's minions the player killed.

neutralMinionsKilled

number

Total score the player received for killing neutral minions.

neutralMinionsKilledEnemyJungle

number

Total score the player received for killing neutral minions in the enemy jungle.

neutralMinionsKilledYourJungle

number

Total score the player received for killing neutral minions in their own jungle.

numDeaths

integer

Number of times the player died.

perks

array, null

Contains information about the perks (runes) chosen by the player in the match.

object

Contains information about the perks (runes) chosen by the player in the match.

PROPERTIES

value

integer

Primary path rune ID.

var1

integer

Post game rune stats.

var2

integer

Post game rune stats.

var3

integer

Post game rune stats.

physicalDamageDealtChampions

number

Amount of physical damage the player dealt to the enemy champions.

physicalDamageDealtPlayer

number

Amount of physical damage the player dealt.

physicalDamageTaken

number

Amount of physical damage the player had taken during the game.

totalDamageDealt

number

Total amount of damage the player dealt.

totalDamageDealtChampions

number

Total amount of damage the player dealt to the enemy champions.

totalDamageDealtToBuildings

number

Total amount of damage the player dealt to the enemy buildings.

totalDamageDealtToObjectives

number

Total amount of damage the player dealt to objectives.

totalDamageDealtToTurrets

number

Total amount of damage the player dealt to the enemy turrets.

totalDamageSelfMitigated

number

The amount of damage the player reduced or blocked on themselves through abilities or shields.

totalDamageShieldedOnTeammates

number

The amount of damage on the teammates the player reduced or blocked.

totalDamageTaken

number

Total amount of damage the player had taken during the game.

totalHealOnTeammates

number

Total amount of health the player restored on their teammates.

totalTimeCCOthers

number

Scaled duration of crowd control effects (full value for stun, partial for slows, etc.) the player laid on enemy champions.

totalTimeCrowdControlDealt

number

Total duration of crowd control effects the player laid on other players and minions.

trueDamageDealtChampions

number

Amount of true damage the player dealt to the enemy champions.

trueDamageDealtPlayer

number

Amount of true damage the player dealt.

trueDamageTaken

number

Amount of true damage the player had taken during the game.

visionScore

number

The player's vision score.

wardKilled

integer

Number of enemy wards the player destroyed.

wardPlaced

integer

Number of wards the player placed.

summonerID

integer

The player's summoner id. This field will be removed in a future release, please use RIOT_SUMMONER_ID within 'references' instead.

summonerLevel

integer

The player's summoner level.

summonerName

string, null

The player's summoner name.

teamID

integer

The internal team id of this player, e.g. 100 or 200. This field will be removed in a future release, please refer to liveDataTeamUrn.

totalGold

integer

Total amount of gold the champion had earned during the game so far.

ultimate

object, null

The player's chosen ultimate (in Ultimate Spellbook game mode).

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the spell cooldown.

name

string, null

Summoner spell name.

references

object, null

A list of external reference IDs for this team, e.g. Riot's esports team ID.

teamID

integer

Indicates the side the team is playing. 100 is blue, 200 is red. 300 denotes neutral teams.

totalGold

integer

A statistic for total gold collected by this team in this game.

towerKills

integer

A statistic for tower kills done by this team in this game.

teamTwo

object, null

The current state for the second team in the game (red).

PROPERTIES

assists

integer

A statistic for kill assists done by players of this team.

baronKills

integer

A statistic for baron kills done by this team in this game.

championsKills

integer

A statistic for champion kills done by this team in this game.

deaths

integer

A statistic counting the champion deaths for this team.

dragonKills

integer

A statistic for dragon kills done by this team in this game.

esportsTeamId

integer

Riot's esports team id. This field will be removed in a future release, please use RIOT_ESPORTS_ID within 'references' instead.

inhibKills

integer

A statistic for inhibitor kills done by this team in this game.

killedDragonTypes

array, null

A list of dragon kills done by this team, will contain e.g. [fire, earth, air].

string

A list of dragon kills done by this team, will contain e.g. [fire, earth, air].

liveDataTeamUrn

string, null

The reference URN used to identify the team across all messages.

players

array, null

A list of players in this team.

object

A list of players in this team.

PROPERTIES

abilityPower

integer

The champion's ability power value.

accountID

integer

The player's account id. This field will be removed in a future release, please use RIOT_ACCOUNT_ID within 'references' instead.

alive

boolean

Indicates whether the player's champion is alive.

armor

integer

The champion's base armor resist value.

armorPenetration

integer

The champion's flat armor penetration value.

armorPenetrationPercent

integer

The champion's percentage armor penetration value.

armorPenetrationPercentBonus

integer

The champion's percentage bonus armor penetration value.

attackDamage

integer

The champion's base attack damage value.

attackSpeed

integer

The champion's base attack speed value.

ccReduction

integer

The champion's current tenacity value in percents.

championID

integer

The player's champion ID.

championName

string, null

The player's champion (internal) name.

cooldownReduction

integer

The champion's ability cooldown reduction value.

currentGold

integer

The champion's current gold balance.

esportsPlayerID

integer

The player's Riot esports player id. This field will be removed in a future release, please use RIOT_ESPORTS_ID within 'references' instead.

esportsTeamID

integer

The player's Riot esports team id. This field will be removed in a future release, please use liveDataTeamUrn to refer to the team instead.

experience

integer

The champion's experience.

goldPerSecond

integer

The champion's gold generation rate.

health

integer

The champion's current health value.

healthMax

integer

The champion's max health value.

healthRegen

integer

The champion's health regeneration value.

items

array, null

A list of player's inventory items.

object

A list of player's inventory items.

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the item cooldown.

itemID

integer

The item internal ID.

purchaseGameTime

integer

The time on ingame clock when the last item of this kind was purchased by the player (milliseconds).

stackSize

integer

Number of items of this kind the player has currently stacked in their inventory.

itemsSold

array, null

Unused. Will be removed in a future release.

object

Unused. Will be removed in a future release.

PROPERTIES

goldGain

integer

itemId

integer

itemsUndo

array, null

Unused. Will be removed in a future release.

object

Unused. Will be removed in a future release.

PROPERTIES

goldGain

integer

itemId

integer

itemIdBeforeUndo

integer

keystoneID

integer

A reference ID to the summoner's keystone, found in 'runesReforged.json' available via Riot's Data Dragon.

level

integer

The champion's level.

lifeSteal

integer

The champion's life steal value.

liveDataPlayerUrn

string, null

The reference URN used to identify the player across all messages.

liveDataTeamUrn

string, null

The player's team reference URN.

magicPenetration

integer

The champion's flat magic penetration value.

magicPenetrationPercent

integer

The champion's percentage magic penetration value.

magicPenetrationPercentBonus

integer

The champion's percentage bonus magic penetration value.

magicResist

integer

The champion's base magic resist value.

participantID

integer

The internal participant slot of the player. This field will be removed in a future release.

pickMode

integer

The player's last pick mode value from the draft.

pickTurn

integer

The player's last pick turn value from the draft.

position

array, null

The current or last known position of the player's champion.

integer

primaryAbilityResource

integer

The champion's current value of the ability resource (mana, energy, etc.).

primaryAbilityResourceMax

integer

The champion's maximum amount of the ability resource (mana, energy, etc.).

primaryAbilityResourceRegen

integer

The champion's current ability resource regen rate.

references

object, null

A list of external reference IDs for this player, e.g. Riot's esports player ID.

respawnTimer

number

Contains the champion's respawn time in seconds if dead.

skills

object, null

The player's champion skills.

spell1

object, null

The player's first chosen summoner spell.

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the spell cooldown.

name

string, null

Summoner spell name.

spell2

object, null

The player's second chosen summoner spell.

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the spell cooldown.

name

string, null

Summoner spell name.

spellVamp

integer

The champion's spell vamp value.

stats

object, null

The player's current match statistics.

PROPERTIES

assists

integer

Number of assists the player performed.

championsKilled

integer

Total number of other team's champions this player killed.

magicDamageDealtChampions

number

Amount of magic damage the player dealt to the enemy champions.

magicDamageDealtPlayer

number

Amount of magic damage the player dealt.

magicDamageTaken

number

Amount of magic damage the player had taken during the game.

minionsKilled

number

Total number of other team's minions the player killed.

neutralMinionsKilled

number

Total score the player received for killing neutral minions.

neutralMinionsKilledEnemyJungle

number

Total score the player received for killing neutral minions in the enemy jungle.

neutralMinionsKilledYourJungle

number

Total score the player received for killing neutral minions in their own jungle.

numDeaths

integer

Number of times the player died.

perks

array, null

Contains information about the perks (runes) chosen by the player in the match.

object

Contains information about the perks (runes) chosen by the player in the match.

PROPERTIES

value

integer

Primary path rune ID.

var1

integer

Post game rune stats.

var2

integer

Post game rune stats.

var3

integer

Post game rune stats.

physicalDamageDealtChampions

number

Amount of physical damage the player dealt to the enemy champions.

physicalDamageDealtPlayer

number

Amount of physical damage the player dealt.

physicalDamageTaken

number

Amount of physical damage the player had taken during the game.

totalDamageDealt

number

Total amount of damage the player dealt.

totalDamageDealtChampions

number

Total amount of damage the player dealt to the enemy champions.

totalDamageDealtToBuildings

number

Total amount of damage the player dealt to the enemy buildings.

totalDamageDealtToObjectives

number

Total amount of damage the player dealt to objectives.

totalDamageDealtToTurrets

number

Total amount of damage the player dealt to the enemy turrets.

totalDamageSelfMitigated

number

The amount of damage the player reduced or blocked on themselves through abilities or shields.

totalDamageShieldedOnTeammates

number

The amount of damage on the teammates the player reduced or blocked.

totalDamageTaken

number

Total amount of damage the player had taken during the game.

totalHealOnTeammates

number

Total amount of health the player restored on their teammates.

totalTimeCCOthers

number

Scaled duration of crowd control effects (full value for stun, partial for slows, etc.) the player laid on enemy champions.

totalTimeCrowdControlDealt

number

Total duration of crowd control effects the player laid on other players and minions.

trueDamageDealtChampions

number

Amount of true damage the player dealt to the enemy champions.

trueDamageDealtPlayer

number

Amount of true damage the player dealt.

trueDamageTaken

number

Amount of true damage the player had taken during the game.

visionScore

number

The player's vision score.

wardKilled

integer

Number of enemy wards the player destroyed.

wardPlaced

integer

Number of wards the player placed.

summonerID

integer

The player's summoner id. This field will be removed in a future release, please use RIOT_SUMMONER_ID within 'references' instead.

summonerLevel

integer

The player's summoner level.

summonerName

string, null

The player's summoner name.

teamID

integer

The internal team id of this player, e.g. 100 or 200. This field will be removed in a future release, please refer to liveDataTeamUrn.

totalGold

integer

Total amount of gold the champion had earned during the game so far.

ultimate

object, null

The player's chosen ultimate (in Ultimate Spellbook game mode).

PROPERTIES

cooldownRemaining

number

Number of seconds remaining until the spell cooldown.

name

string, null

Summoner spell name.

references

object, null

A list of external reference IDs for this team, e.g. Riot's esports team ID.

teamID

integer

Indicates the side the team is playing. 100 is blue, 200 is red. 300 denotes neutral teams.

totalGold

integer

A statistic for total gold collected by this team in this game.

towerKills

integer

A statistic for tower kills done by this team in this game.

winningTeam

integer

This field indicates the winning ingame team. The field will be removed in a future release, winningTeamUrn should be used instead.

winningTeamUrn

string, null

Holds the URN of the team that won this game once the game has ended and a winner is determined.

EXAMPLE

SNAPSHOT/PLAYER/UPDATE_POSITIONS

This message is sent when a stats update was received, usually once per second.
Download

PROPERTIES

gameTime

integer

The ingame clock's time in milliseconds.

positions

array, null

A list of all player's positions (or last known positions).

object

A list of all player's positions (or last known positions).

PROPERTIES

playerUrn

string, null

The player reference URN.

position

array, null

The ingame coordinates of the player's position.

integer

teamUrn

string, null

The player's team reference URN.

EXAMPLE

SNAPSHOT/TEAM/UPDATE

This message is sent every time an update to the draft is received.
Download

PROPERTIES

bannedChampions

array, null

A list of bans that happened during the draft so far.

object

A list of bans that happened during the draft so far.

PROPERTIES

championId

integer

The champion internal ID.

liveDataTeamUrn

string, null

Reference URN of the team that banned the champion.

pickTurn

integer

The turn number on which the champion was banned.

references

object, null

This field is unused.

teamId

integer

pickTurn

integer

The turn number within the current draft cycle.

teamOne

object, null

The current team draft for the first team (blue).

PROPERTIES

liveDataTeamUrn

string, null

The reference URN used to identify the team across all messages.

players

array, null

A list of players in this team in this draft turn. This list may change as players join the lobby.

object

A list of players in this team in this draft turn. This list may change as players join the lobby.

PROPERTIES

championID

integer

The ID of the champion the player has currently selected. This value may change over time as players swap or hover the mouse over champions as they pick.

liveDataPlayerUrn

string, null

The reference URN used to identify the player across all messages.

liveDataTeamUrn

string, null

The player's team reference URN.

pickMode

integer

The player's current state of the champion pick: 0 — not picked, 1 — selected but not confirmed, 2 — picked.

pickTurn

integer

The player's turn number in the draft cycle.

references

object, null

A list of external reference IDs for this player, e.g. Riot's esports player ID.

summonerName

string, null

The player's summoner name.

references

object, null

A list of external reference IDs for this team, e.g. Riot's esports team ID.

teamTwo

object, null

The current team draft for the second team (red).

PROPERTIES

liveDataTeamUrn

string, null

The reference URN used to identify the team across all messages.

players

array, null

A list of players in this team in this draft turn. This list may change as players join the lobby.

object

A list of players in this team in this draft turn. This list may change as players join the lobby.

PROPERTIES

championID

integer

The ID of the champion the player has currently selected. This value may change over time as players swap or hover the mouse over champions as they pick.

liveDataPlayerUrn

string, null

The reference URN used to identify the player across all messages.

liveDataTeamUrn

string, null

The player's team reference URN.

pickMode

integer

The player's current state of the champion pick: 0 — not picked, 1 — selected but not confirmed, 2 — picked.

pickTurn

integer

The player's turn number in the draft cycle.

references

object, null

A list of external reference IDs for this player, e.g. Riot's esports player ID.

summonerName

string, null

The player's summoner name.

references

object, null

A list of external reference IDs for this team, e.g. Riot's esports team ID.

EXAMPLE

LolMessagePayload

PROPERTIES

EXAMPLE