Skip to main content
Loading...

Please read the overwolf.games.events documentation page to learn how to use Overwolf game events.

Note that LOL Arena, LOL Arena PBE and LOL share the same Game ID.

tip

Note that you can also use the LOL game launcher events. Read more here.

Sample Apps

Available Features

Game events status

It's highly recommended to communicate errors and warnings to your app users. Check current game event status here or easily check game event status from your app using our API.

info

Because LOL and LOL Arena share the same GameID, when checking LOL Arenas game event status please use 21556 as the unique GameID for LOL Arena and 215561 for LOL Arena PBE.

gep_internal

Info Updates

keyCategoryValuesNotesSince GEP Ver.
gep_internalgep_internalLocal + Public version numberSee notes143.0

gep_internal note

Data Example:

{"info":{"gep_internal":{"version_info":"{"local_version":"157.0.1","public_version":"157.0.1","is_updated":true}"}},"feature":"gep_internal"}

live_client_data

Info Updates

keyCategoryValuesNotesSince GEP Ver.
active_playerlive_client_dataIn-game data received by the client.See notes230.0
all_playerslive_client_dataIn-game data received by the client.See notes230.0
eventslive_client_dataIn-game data received by the client.See notes230.0
game_datalive_client_dataIn-game data received by the client.See notes230.0

active_player note

Click to see some data example
{
"info": {
"live_client_data": {
"active_player": {
"abilities": {
"E": {
"abilityLevel": 0,
"displayName": "Stacked Deck",
"id": "CardmasterStack",
"rawDescription": "GeneratedTip_Spell_CardmasterStack_Description",
"rawDisplayName": "GeneratedTip_Spell_CardmasterStack_DisplayName"
},
"Passive": {
"displayName": "Loaded Dice",
"id": "SecondSight",
"rawDescription": "GeneratedTip_Passive_SecondSight_Description",
"rawDisplayName": "GeneratedTip_Passive_SecondSight_DisplayName"
},
"Q": {
"abilityLevel": 0,
"displayName": "Wild Cards",
"id": "WildCards",
"rawDescription": "GeneratedTip_Spell_WildCards_Description",
"rawDisplayName": "GeneratedTip_Spell_WildCards_DisplayName"
},
"R": {
"abilityLevel": 0,
"displayName": "Destiny",
"id": "Destiny",
"rawDescription": "GeneratedTip_Spell_Destiny_Description",
"rawDisplayName": "GeneratedTip_Spell_Destiny_DisplayName"
},
"W": {
"abilityLevel": 0,
"displayName": "Pick a Card",
"id": "PickACard",
"rawDescription": "GeneratedTip_Spell_PickACard_Description",
"rawDisplayName": "GeneratedTip_Spell_PickACard_DisplayName"
}
},
"championStats": {
"abilityHaste": 0,
"abilityPower": 0,
"armor": 21,
"armorPenetrationFlat": 0,
"armorPenetrationPercent": 1,
"attackDamage": 25,
"attackRange": 0,
"attackSpeed": 0.6510000228881836,
"bonusArmorPenetrationPercent": 1,
"bonusMagicPenetrationPercent": 1,
"cooldownReduction": 0,
"critChance": 0,
"critDamage": 0,
"currentHealth": 534,
"healthRegenRate": 0,
"lifeSteal": 0,
"magicLethality": 0,
"magicPenetrationFlat": 0,
"magicPenetrationPercent": 1,
"magicResist": 30,
"maxHealth": 534,
"moveSpeed": 330,
"physicalLethality": 0,
"resourceMax": 333,
"resourceRegenRate": 0,
"resourceType": "MANA",
"resourceValue": 333,
"spellVamp": 0,
"tenacity": 0
},
"currentGold": 0,
"fullRunes": {
"generalRunes": [
{
"displayName": "Dark Harvest",
"id": 8128,
"rawDescription": "perk_tooltip_DarkHarvest",
"rawDisplayName": "perk_displayname_DarkHarvest"
},
{
"displayName": "Taste of Blood",
"id": 8139,
"rawDescription": "perk_tooltip_TasteOfBlood",
"rawDisplayName": "perk_displayname_TasteOfBlood"
},
{
"displayName": "Eyeball Collection",
"id": 8138,
"rawDescription": "perk_tooltip_EyeballCollection",
"rawDisplayName": "perk_displayname_EyeballCollection"
},
{
"displayName": "Ravenous Hunter",
"id": 8135,
"rawDescription": "perk_tooltip_RavenousHunter",
"rawDisplayName": "perk_displayname_RavenousHunter"
},
{
"displayName": "Presence of Mind",
"id": 8009,
"rawDescription": "perk_tooltip_PresenceOfMind",
"rawDisplayName": "perk_displayname_PresenceOfMind"
},
{
"displayName": "Coup de Grace",
"id": 8014,
"rawDescription": "perk_tooltip_CoupDeGrace",
"rawDisplayName": "perk_displayname_CoupDeGrace"
}
],
"keystone": {
"displayName": "Dark Harvest",
"id": 8128,
"rawDescription": "perk_tooltip_DarkHarvest",
"rawDisplayName": "perk_displayname_DarkHarvest"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
},
"statRunes": [
{ "id": 5008, "rawDescription": "perk_tooltip_StatModAdaptive" },
{ "id": 5008, "rawDescription": "perk_tooltip_StatModAdaptive" },
{ "id": 5003, "rawDescription": "perk_tooltip_StatModMagicResist" }
]
},
"level": 1,
"summonerName": "Sh4rgaas"
}
}
},
"feature": "live_client_data"
}

all_players note

Click to see some data example
{
"info": {
"live_client_data": {
"all_players": [
{
"championName": "Twisted Fate",
"isBot": false,
"isDead": false,
"items": [
{
"canUse": true,
"consumable": true,
"count": 1,
"displayName": "Poro - Snax",
"itemID": 2052,
"price": 0,
"rawDescription": "game_item_description_2052",
"rawDisplayName": "game_item_displayname_2052",
"slot": 6
}
],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_TwistedFate",
"rawSkinName": "game_character_skin_displayname_TwistedFate_9",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Dark Harvest",
"id": 8128,
"rawDescription": "perk_tooltip_DarkHarvest",
"rawDisplayName": "perk_displayname_DarkHarvest"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 9,
"skinName": "Cutpurse Twisted Fate",
"summonerName": "Sh4rgaas",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Ghost",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerHaste_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerHaste_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
}
},
"team": "CHAOS"
},
{
"championName": "Brand",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Brand",
"rawSkinName": "game_character_skin_displayname_Brand_2",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Dark Harvest",
"id": 8128,
"rawDescription": "perk_tooltip_DarkHarvest",
"rawDisplayName": "perk_displayname_DarkHarvest"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 2,
"skinName": "Vandal Brand",
"summonerName": "Gordon xD",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Heal",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerHeal_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerHeal_DisplayName"
}
},
"team": "ORDER"
},
{
"championName": "Gragas",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Gragas",
"rawSkinName": "game_character_skin_displayname_Gragas_10",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Dark Harvest",
"id": 8128,
"rawDescription": "perk_tooltip_DarkHarvest",
"rawDisplayName": "perk_displayname_DarkHarvest"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 10,
"skinName": "Arctic Ops Gragas",
"summonerName": "IM Piotrovic",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Ignite",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerDot_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerDot_DisplayName"
}
},
"team": "ORDER"
},
{
"championName": "Shen",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Shen",
"rawSkinName": "game_character_skin_displayname_Shen_6",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Hail of Blades",
"id": 9923,
"rawDescription": "perk_tooltip_HailOfBlades",
"rawDisplayName": "perk_displayname_HailOfBlades"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 6,
"skinName": "TPA Shen",
"summonerName": "ToxicMolester",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Clarity",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerMana_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerMana_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
}
},
"team": "ORDER"
},
{
"championName": "Vayne",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Vayne",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Hail of Blades",
"id": 9923,
"rawDescription": "perk_tooltip_HailOfBlades",
"rawDisplayName": "perk_displayname_HailOfBlades"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 0,
"summonerName": "ToxikBull",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Barrier",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerBarrier_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerBarrier_DisplayName"
}
},
"team": "ORDER"
},
{
"championName": "Pantheon",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Pantheon",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Electrocute",
"id": 8112,
"rawDescription": "perk_tooltip_Electrocute",
"rawDisplayName": "perk_displayname_Electrocute"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 0,
"summonerName": "Haorn",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Mark",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerSnowball_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerSnowball_DisplayName"
}
},
"team": "ORDER"
},
{
"championName": "Rell",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Rell",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Aftershock",
"id": 8439,
"rawDescription": "perk_tooltip_VeteranAftershock",
"rawDisplayName": "perk_displayname_VeteranAftershock"
},
"primaryRuneTree": {
"displayName": "Resolve",
"id": 8400,
"rawDescription": "perkstyle_tooltip_7204",
"rawDisplayName": "perkstyle_displayname_7204"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 0,
"summonerName": "Tαkumi Usui",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Mark",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerSnowball_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerSnowball_DisplayName"
}
},
"team": "CHAOS"
},
{
"championName": "Anivia",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Anivia",
"rawSkinName": "game_character_skin_displayname_Anivia_8",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Dark Harvest",
"id": 8128,
"rawDescription": "perk_tooltip_DarkHarvest",
"rawDisplayName": "perk_displayname_DarkHarvest"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Sorcery",
"id": 8200,
"rawDescription": "perkstyle_tooltip_7202",
"rawDisplayName": "perkstyle_displayname_7202"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 8,
"skinName": "Papercraft Anivia",
"summonerName": "TheShackledCaps",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Barrier",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerBarrier_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerBarrier_DisplayName"
}
},
"team": "CHAOS"
},
{
"championName": "Jhin",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Jhin",
"rawSkinName": "game_character_skin_displayname_Jhin_3",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Dark Harvest",
"id": 8128,
"rawDescription": "perk_tooltip_DarkHarvest",
"rawDisplayName": "perk_displayname_DarkHarvest"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Precision",
"id": 8000,
"rawDescription": "perkstyle_tooltip_7201",
"rawDisplayName": "perkstyle_displayname_7201"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 3,
"skinName": "SKT T1 Jhin",
"summonerName": "SzczodryMarynarz",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Barrier",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerBarrier_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerBarrier_DisplayName"
}
},
"team": "CHAOS"
},
{
"championName": "Lissandra",
"isBot": false,
"isDead": false,
"items": [],
"level": 1,
"position": "NONE",
"rawChampionName": "game_character_displayname_Lissandra",
"rawSkinName": "game_character_skin_displayname_Lissandra_3",
"respawnTimer": 0,
"runes": {
"keystone": {
"displayName": "Electrocute",
"id": 8112,
"rawDescription": "perk_tooltip_Electrocute",
"rawDisplayName": "perk_displayname_Electrocute"
},
"primaryRuneTree": {
"displayName": "Domination",
"id": 8100,
"rawDescription": "perkstyle_tooltip_7200",
"rawDisplayName": "perkstyle_displayname_7200"
},
"secondaryRuneTree": {
"displayName": "Sorcery",
"id": 8200,
"rawDescription": "perkstyle_tooltip_7202",
"rawDisplayName": "perkstyle_displayname_7202"
}
},
"scores": {
"assists": 0,
"creepScore": 0,
"deaths": 0,
"kills": 0,
"wardScore": 0
},
"skinID": 3,
"skinName": "Program Lissandra",
"summonerName": "JALLLAA",
"summonerSpells": {
"summonerSpellOne": {
"displayName": "Mark",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerSnowball_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerSnowball_DisplayName"
},
"summonerSpellTwo": {
"displayName": "Flash",
"rawDescription": "GeneratedTip_SummonerSpell_SummonerFlash_Description",
"rawDisplayName": "GeneratedTip_SummonerSpell_SummonerFlash_DisplayName"
}
},
"team": "CHAOS"
}
]
}
},
"feature": "live_client_data"
}

events note

Data Example:

{"info":{"live_client_data":{"events":"{"Events":[{"EventID":0,"EventName":"GameStart","EventTime":0.0417339988052845}]}"}},"feature":"live_client_data"}

game_data note

Data Example:

{
"info": {
"live_client_data": {
"game_data": {
"gameMode": "ARAM",
"gameTime": 0.0417339988052845,
"mapName": "Map12",
"mapNumber": 12,
"mapTerrain": "Default"
}
}
},
"feature": "live_client_data"
}

matchState

Info Updates

keyCategoryValuesNotesSince GEP Ver.
matchStartedgame_infotrue/false (string)See notes230.0
matchIdgame_infoCurrent match idSee notes230.0

matchStarted note

Data Example:

{"info":{"game_info":{"matchStarted":"true"}},"feature":"matchState"}

matchID note

Data Example:

{"info":{"game_info":{"matchId":"2603009084"}},"feature":"game_info"}

Events

EventEvent DataFired WhenNotesSince GEP Ver.
matchStartnullMatch has startedMatch has started230.0

match_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
round_numbermatch_infoThe number of the current roundSee notes230.0
match_outcomematch_infoThe final march outcomeSee notes230.0

round_number notes

Data example:

{"info":{"match_info":{"round_number":"4"}},"feature":"match_info"}

match_outcome note

Match outcome at the end of the match with your team's place

Possible status values:

  • victory
  • defeat

Possible place values are 1, 2, 3, 4

Data Example:

{"info":{"match_info":{"match_outcome":"{\"status\":\"defeat\",\"place\":4}"}},"feature":"match_info"}

Events

EventEvent DataFired WhenNotesSince GEP Ver.
round_startthe current round numberA round startSee notes230.0
round_endnullA round is won or lostSee notes230.0
round_outcomenullAt the end of the current roundSee notes230.0
battle_startnullThe battle startSee notes253.0
battle_endnullThe battle endSee notes253.0

round_start note

Data Example:

{"events":[{"name":"round_start","data":"3"}]}

round_end note

Data Example:

{"events":[{"name":"round_end","data":""}]}

round_outcome notes

Data example:

{"events":[{"name":"round_outcome","data":"defeat"}]}

battle_start note

Data Example:

{"events":[{"name":"battle_start","data":""}]}

battle_end note

Data Example:

{"events":[{"name":"battle_end","data":""}]}

summoner_info

Info Updates

keyCategoryValuesNotesSince GEP Ver.
idsummoner_infoUser’s Summoner IdFired immediately with game start. See notes230.0
regionsummoner_infoUser’s region (EUE, EUW, etc.) or PBE client (See notes)See notes230.0
levelsummoner_infoUser’s summoner levelSee notes230.0
accountIdsummoner_infoUser’s account idSee notes230.0

id note

Data Example:

{"info":{"summoner_info":{"id":"21549264"}},"feature":summoner_info}

region note

For a full list of regions and Riot Games Servers please visit here.

Data Example:

{"info":{"summoner_info":{"region":"EUNE"}},"feature":summoner_info}

Note that if the current client is a PBE client, instead of the region value, it returns "PBE":

{"info":{"summoner_info":{"region":"PBE"}},"feature":summoner_info}

Note that you can also get this info earlier by using the LEP region info-update.

level note

Data Example:

{"info":{"summoner_info":{"level":"39"}},"feature":summoner_info}

accountId note

Data Example:

{"info":{"summoner_info":{"accountId":"25112115"}},"feature":summoner_info}

teams

Info Updates

keyCategoryValuesNotesSince GEP Ver.
teamsgame_infoDeprecatedSee notes70.0
arena_teamsgame_infoA JSON object with the teams formationSee notes70.0

teams note

caution

teams is deprecated and will be replaced by arena_teams - See notes

arena_teams note

The info-update JSON response will return the following parameters:

  • team - a random team number
  • players - an array of players
    • name - the player name with tagline
    • is_local - true/false to identify the local player
{"feature":"teams","category":"game_info","key":"arena_teams","value":"[{\"team\":\"0\",\"players\":[{\"name\":\"Rosenkeskole8#EUW\"},{\"is_local\":false},{\"name\":\"Rosenkikole9#EUW\"},{\"is_local\":false}]},{\"team\":\"1\",\"players\":[{\"name\":\"Atgucuu#EUW\"},{\"is_local\":false},{\"name\":\"Maks#EUW\"},{\"is_local\":false}]},{\"team\":\"2\",\"players\":[{\"name\":\"Nanoco#6874\"},{\"is_local\":true},{\"name\":\"iamigMac#EUW\"},{\"is_local\":false}]},{\"team\":\"3\",\"players\":[{\"name\":\"ProusRex#EUW\"},{\"is_local\":false},{\"name\":\"Vipel60#EUW\"},{\"is_local\":false}]},{\"team\":\"4\",\"players\":[{\"name\":\"Shâ#EUW\"},{\"is_local\":false},{\"name\":\"Stgaim#EUW\"},{\"is_local\":false}]},{\"team\":\"5\",\"players\":[{\"name\":\"7mdo#EUW\"},{\"is_local\":false},{\"name\":\"Pacan#EUW\"},{\"is_local\":false}]},{\"team\":\"6\",\"players\":[{\"name\":\"Tamaotau#Mommy\"},{\"is_local\":false},{\"name\":\"xM4#EUW\"},{\"is_local\":false}]},{\"team\":\"7\",\"players\":[{\"name\":\"Rosenkild3#EUW\"},{\"is_local\":false},{\"name\":\"skoleX#EUW\"},{\"is_local\":false}]}]"}

level

Info Updates

keyCategoryValuesNotesSince GEP Ver.
levellevelCurrent level of the player's championFired immediately when the game starts, updates whenever the champion levels up0.19
{ "info": {"level": { "level": "1" }}, "feature": "level"}

match

Info Updates

keyCategoryValuesNotesSince GEP Ver.
match_startedgame_infoMatch has startedSee notes230.0

Events

keyCategoryValuesNotesSince GEP Ver.
match_startmatch start eventSee notes230.0

match_started note

Data Example:

{"feature":"match","category":"game_info","key":"match_started","value":true}

match_start note

Data Example:

{"events":[{"name":"match_start","data":""}]}

augments

Info Updates

keyCategoryValuesNotesSince GEP Ver.
augmentsmeList of available augmentsSee notes230.0
picked_augmentmeThe last augment that the player pickedSee notes222.0

augments note

Data Example:

{"feature":"augments","category":"me","key":"augments","value":"{\"augment_1\":{\"name\":\"TFT8_Augment_DefenderTrait\"}, \"augment_2\":{\"name\":\"TFT7_Augment_PandorasBench\"}, \"augment_3\":{\"name\":\"TFT6_Augment_SecondWind1\"}, }"}

picked_augment note

Data Example:

{"info":{"me":{"picked_augment":"{\"slot_1\":{\"name\":\"TFT9_Augment_CyberneticBulk3\"}, \"slot_2\":{\"name\":\"TFT9_Augment_SettTheBoss\"}, \"slot_3\":{\"name\":\"\"}}"}},"feature":"augments"}

damage

Info Updates

keyCategoryValuesNotesSince GEP Ver.
total_damage_dealtdamageValue of all damage done in the match (Float).See notes139.0
total_damage_dealt_to_championsdamageValue of all damage done to champions in the match (Float).See notes139.0
total_damage_takendamageValue of all the damage that was taken in the match (Float).See notes139.0
total_damage_self_mitigateddamageValue of all mitigated damage in the match (Float).See notes139.0

total_damage_dealt note

Data Example:

{"info":{"damage":{"total_damage_dealt":"65.000000"}},"feature":"damage"}

total_damage_dealt_to_champions note

Data Example:

{"info":{"damage":{"total_damage_dealt_to_champions":"65.000000"}},"feature":"damage"}

total_damage_taken note

Data Example:

{"info":{"damage":{"total_damage_taken":"8.452381"}},"feature":"damage"}

total_damage_self_mitigated note

Data Example:

{"info":{"damage":{"total_damage_self_mitigated":"62.607620"}},"feature":"damage"}

Events

EventEvent DataFired WhenNotesSince GEP Ver.
physical_damage_dealt_playerFloatDamaging an opponent with physical damage.See notes139.0
magic_damage_dealt_playerFloatDamaging an opponent with magic damage.See notes139.0
true_damage_dealt_playerFloatDamaging an opponent with true damage.See notes139.0
physical_damage_dealt_to_championsFloatPhysical damage is inflicted on any opponent.See notes139.0
magic_damage_dealt_to_championsFloatMagic damage is inflicted on any opponent.See notes139.0
true_damage_dealt_to_championsFloatTrue damage is inflicted on any opponent.See notes139.0
physical_damage_takenFloatReceiving physical damage from an opponent.See notes139.0
magic_damage_takenFloatReceiving magic damage from an opponent.See notes139.0
true_damage_takenFloatReceiving true damage from an opponent.See notes139.0

physical_damage_dealt_player note

Data Example:

{"events":[{"name":"physical_damage_dealt_player","data":"47.65625"}]}

magic_damage_dealt_player note

Data Example:

{"events":[{"name":"magic_damage_dealt_player","data":"65.0"}]}

true_damage_dealt_player note

Data Example:

{"events":[{"name":"true_damage_dealt_player","data":"14.0"}]}

physical_damage_dealt_to_champions note

Data Example:

{"events":[{"name":"physical_damage_dealt_to_champions","data":"47.65625"}]}

magic_damage_dealt_to_champions note

Data Example:

{"events":[{"name":"magic_damage_dealt_to_champions","data":"65.0"}]}

true_damage_dealt_to_champions note

Data Example:

{"events":[{"name":"true_damage_dealt_to_champions","data":"14.0"}]}

physical_damage_taken note

Data Example:

{"events":[{"name":"physical_damage_taken","data":"8.452381"}]}

magic_damage_taken note

Data Example:

{"events":[{"name":"magic_damage_taken","data":"11.355035"}]}

true_damage_taken note

Data Example:

{"events":[{"name":"true_damage_taken","data":"6.0"}]}

heal

Info Updates

keyCategoryValuesNotesSince GEP Ver.
total_healhealValue of all healing done in the match (Float).See notes139.0
total_heal_on_teammateshealValue of all healing on teammates in the match (Float).See notes139.0
total_units_healedhealValue of amount of units healed in the match (Float).See notes139.0

total_heal note

Data Example:

{"info":{"heal":{"total_heal":"27.0"}},"feature":"heal"}

total_heal_on_teammates note

Data Example:

{"info":{"heal":{"total_heal_on_teammates":"27.0"}},"feature":"heal"}

total_units_healed note

Data Example:

{"info":{"heal":{"total_units_healed":"1.0"}},"feature":"heal"}