Leaderboard module
This module manages:
- GET Leaderboard
- GET Leaderboard types
It is located at https://web-api.wynncraft.com/api/leaderboards
Get leaderboard
GET .../leaderboads/<str:lb_type> 10 minutes TTL
Guilds:
[
"lbType",
"lbType",
# [...]
]
[
"guildLevel",
"guildTerritory",
"guildWars",
"professionsGlobalLevel",
"combatGlobalLevel",
"mergedGlobalLevel",
"woodcuttingLevel",
"professionsSoloLevel",
"miningLevel",
"fishingLevel",
"farmingLevel",
"alchemismLevel",
"armouringLevel",
"cookingLevel",
"jewelingLevel",
"scribingLevel",
"tailoringLevel",
"weaponsmithingLevel",
"woodworkingLevel",
"mergedSoloLevel",
"combatSolo",
"huntedLevel",
"hardcoreLevel",
"craftsmanLevel",
"ironmanLevel",
"hicLevel",
"hichLevel",
"hardcoreLegacyLevel",
"hichContent",
"combatSoloLevel"
]
Players:
{
"rank": {
"name": str,
"uuid": str,
"rank": str,
"score": int,
"metadata": {
"xp": int,
"playtime": int
},
"rankBadge": str,
"supportRank": str,
"shortenedRank": str,
"legacyRankColor": {
"sub": str,
"main": str
},
"characterType": str,
"characterUuid": str,
}
}
{
"1": {
"name": "olinus10",
"uuid": "55e5c45e-432c-471e-8ae2-dbbf41dc9f69",
"rank": "Media",
"score": 16449,
"metadata": {
"xp": 150876095,
"playtime": 5782
},
"rankBadge": "nextgen/badges/rank_media.svg",
"supportRank": "champion",
"shortenedRank": null,
"legacyRankColor": {
"sub": "#AA00AA",
"main": "#FF55FF"
}
}
}
{
"1": {
"name": "Cal_and_Ben",
"uuid": "fddf49cb-1ba0-48f7-87dd-e0a3f140af69",
"rank": "Moderator",
"score": 131,
"metadata": {
"xp": 210196526,
"level": 131,
"playtime": 29523
},
"nickname": "Shubdow",
"rankBadge": "nextgen/badges/rank_moderator.svg",
"supportRank": "champion",
"shortenedRank": "Mod",
"characterType": "shaman",
"characterUuid": "7ef6b95d-1c80-4cf8-9033-e367e219a41f",
"legacyRankColor": {
"sub": "#ffff55",
"main": "#ffaa00"
}
}
}
Gamemodes:
{
"rank": {
"name": str,
"uuid": str,
"rank": str,
"score": int,
"metadata": {
"xp": int,
"playtime": int
},
"rankBadge": str,
"supportRank": str,
"shortenedRank": str,
"legacyRankColor": {
"sub": str,
"main": str
},
"characterType": str,
"characterUuid": str,
}
}
{
"1": {
"name": "linnyflower",
"uuid": "f8aea412-f806-4c34-953a-2b9a4fd7c3ce",
"rank": "Item",
"score": 106,
"metadata": {
"xp": 61216188,
"playtime": 217
},
"nickname": null,
"rankBadge": "nextgen/badges/rank_item.svg",
"supportRank": "champion",
"shortenedRank": null,
"characterType": "shaman",
"characterUuid": "10e15fb6-e072-44eb-a04d-0600d5d12069",
"legacyRankColor": {
"sub": "#55ffff",
"main": "#00aaaa"
}
}
}
{
"1": {
"name": "linnyflower",
"uuid": "f8aea412-f806-4c34-953a-2b9a4fd7c3ce",
"rank": "Item",
"score": 106,
"metadata": {
"xp": 108292867,
"playtime": 168
},
"nickname": null,
"rankBadge": "nextgen/badges/rank_item.svg",
"supportRank": "champion",
"shortenedRank": null,
"characterData": {
"xp": 108292867,
"pvp": {
"kills": 0,
"deaths": 0
},
"type": "MAGE",
"death": 0,
"level": 106,
"logins": 2348,
"quests": [
"Mini-Quest - Slay Dragonlings",
"Mini-Quest - Slay Angels",
"Mini-Quest - Slay Conures",
"One Thousand Meters Under",
"The Envoy Part II",
"The Envoy Part I",
"Mini-Quest - Slay Jinkos",
"The Qira Hive",
"Troubled Tribesmen",
"Realm of Light IV - Finding the Light",
"WynnExcavation Site D",
"Mini-Quest - Slay Dead Villagers",
"Haven Antiquity",
"Grand Youth",
"Memory Paranoia",
"Lost Soles",
"Lost Royalty",
"Mini-Quest - Slay Idols",
"Realm of Light III - A Headless History",
"Lost in the Jungle",
"The Order of the Grook",
"WynnExcavation Site C",
"Zhight Island",
"The Shadow of the Beast",
"Death Whistle",
"Master Piece",
"Corrupted Betrayal",
"Crop Failure",
"The Maiden Tower",
"A Grave Mistake",
"Mini-Quest - Slay Slimes",
"Rise of the Quartron",
"WynnExcavation Site B",
"Blazing Retribution",
"UndericeÀ",
"Fate of the Fallen",
"Heart of Llevigar",
"Tower of Ascension",
"Mini-Quest - Slay Creatures of Nesaak Forest",
"Clearing the Camps",
"Canyon Condor",
"WynnExcavation Site A",
"Tribal Aggression",
"Mini-Quest - Slay Coyotes",
"Kingdom of Sand",
"Meaningful Holiday",
"A Sandy Scandal",
"Green Gloop",
"The Mercenary",
"Mini-Quest - Slay Scarabs",
"Misadventure on the Sea",
"The Corrupted Village",
"Deja Vu",
"Tempo Town Trouble",
"Mini-Quest - Slay Skeletons",
"Dwelling Walls",
"The Dark Descent",
"Pit of the Dead",
"Lava Springs",
"Mini-Quest - Slay Mooshrooms",
"Tunnel Trouble",
"Mini-Quest - Slay Spiders",
"Poisoning the Pest",
"Mini-Quest - Gather Salmon II",
"Mini-Quest - Gather Bass II",
"Mini-Quest - Gather Bass III",
"Mini-Quest - Gather Bass",
"Mini-Quest - Gather Rice II",
"Mini-Quest - Gather Molten Eel IV",
"Mini-Quest - Gather Molten Eel III",
"Mini-Quest - Gather Molten Eel II",
"Mini-Quest - Gather Molten Ore",
"Mini-Quest - Gather Molten Ore III",
"Mini-Quest - Gather Sorghum II",
"Mini-Quest - Gather Jungle Logs",
"Mini-Quest - Gather Oak Logs",
"Mini-Quest - Gather Copper",
"Mini-Quest - Gather Gudgeon",
"Mini-Quest - Gather Wheat",
"Mini-Quest - Gather Granite",
"Mini-Quest - Gather Barley",
"Mini-Quest - Gather Trout",
"Mini-Quest - Gather Birch Logs",
"Mini-Quest - Gather Gold",
"Mini-Quest - Gather Salmon",
"Mini-Quest - Gather Willow Logs",
"Mini-Quest - Gather Oats",
"Mini-Quest - Gather Willow Logs II",
"Mini-Quest - Gather Acacia Logs",
"Mini-Quest - Gather Sandstone",
"Mini-Quest - Gather Carp",
"Mini-Quest - Gather Malt",
"Mini-Quest - Gather Sandstone II",
"Mini-Quest - Gather Malt II",
"Mini-Quest - Gather Acacia Logs II",
"Mini-Quest - Gather Carp II",
"Mini-Quest - Gather Gold II",
"Mini-Quest - Gather Oats II",
"Mini-Quest - Gather Icefish",
"Mini-Quest - Gather Spruce Logs",
"Mini-Quest - Gather Spruce Logs II",
"Mini-Quest - Gather Cobalt",
"Mini-Quest - Gather Piranhas",
"Mini-Quest - Gather Jungle Logs II",
"Mini-Quest - Gather Piranhas II",
"Mini-Quest - Gather Koi",
"Mini-Quest - Gather Koi II",
"Mini-Quest - Gather Iron II",
"Mini-Quest - Gather Icefish II",
"Mini-Quest - Gather Iron",
"Mini-Quest - Gather Dark Logs III",
"Mini-Quest - Gather Cobalt III",
"Mini-Quest - Gather Pine Logs II",
"Mini-Quest - Gather Diamonds IV",
"Mini-Quest - Gather Diamonds",
"Mini-Quest - Gather Diamonds II",
"Mini-Quest - Gather Diamonds III"
],
"dungeons": {
"list": {
"Ice Barrows": 1,
"Infested Pit": 1,
"Fallen Factory": 1,
"Lost Sanctuary": 1,
"Decrepit Sewers": 2,
"Sand-Swept Tomb": 4,
"Eldritch Outlook": 13,
"Underworld Crypt": 1,
"Undergrowth Ruins": 7,
"Galleon's Graveyard": 1,
"Corrupted Infested Pit": 11,
"Corrupted Lost Sanctuary": 1,
"Corrupted Decrepit Sewers": 8
},
"total": 52
},
"gamemode": [
"ironman",
"craftsman",
"hunted",
"hardcore"
],
"playtime": 168,
"xpPercent": 100,
"mobsKilled": 59521,
"chestsFound": 1067,
"discoveries": 475,
"professions": {
"Mining": {
"level": 105,
"xpPercent": 72
},
"Cooking": {
"level": 10,
"xpPercent": 95
},
"Farming": {
"level": 106,
"xpPercent": 81
},
"Fishing": {
"level": 105,
"xpPercent": 40
},
"Jeweling": {
"level": 100,
"xpPercent": 95
},
"Alchemism": {
"level": 103,
"xpPercent": 32
},
"Armouring": {
"level": 102,
"xpPercent": 20
},
"Tailoring": {
"level": 99,
"xpPercent": 8
},
"Woodcutting": {
"level": 104,
"xpPercent": 42
},
"Woodworking": {
"level": 102,
"xpPercent": 44
}
},
"skillPoints": {
"Agility": 40,
"Defense": 62,
"Strength": 8,
"Dexterity": 10,
"Intelligence": 80
},
"blocksWalked": -637881234,
"itemsIdentified": 0
},
"characterType": "mage",
"characterUuid": "ba54fccd-6c5f-4a58-9971-68e3674a5509",
"legacyRankColor": {
"sub": "#55ffff",
"main": "#00aaaa"
}
}
}
TIP
Player leaderboards have optional keys: characterUuid and characterType included if the lb_type is a leaderboard on solo characters (e.g. professions leaderboards or gamemodes leaderboards). metadata contain variable keys depending on the leaderboard type
Some gamemode leaderboards includes characterData, it contains stats of the related character with the same structure as player stats character data
Examples results have been truncated to a small amount of items
Leaderboard types
GET .../leaderboads/types 10 minutes TTL
[
"lbType",
"lbType",
# [...]
]
[
"guildLevel",
"guildTerritory",
"guildWars",
"professionsGlobalLevel",
"combatGlobalLevel",
"mergedGlobalLevel",
"woodcuttingLevel",
"professionsSoloLevel",
"miningLevel",
"fishingLevel",
"farmingLevel",
"alchemismLevel",
"armouringLevel",
"cookingLevel",
"jewelingLevel",
"scribingLevel",
"tailoringLevel",
"weaponsmithingLevel",
"woodworkingLevel",
"mergedSoloLevel",
"combatSolo",
"huntedLevel",
"hardcoreLevel",
"craftsmanLevel",
"ironmanLevel",
"hicLevel",
"hichLevel",
"hardcoreLegacyLevel",
"hichContent",
"combatSoloLevel"
]
Use this list to know what leaderboard you can request in get leaderboard