Wynncraft Leaderboard Resource
Guild
GET https://api.wynncraft.com/public_api.php?action=statsLeaderboard&type=guild&timeframe={timeframe}
Returns a leaderboard of guilds (represented as an array of guild leaderboard objects) with a length of 100. Sorted by territories currently owned, then level. Timeframe can be alltime.
Guild Leaderboard Object
| Field | Type | Description | Options/Details |
|---|---|---|---|
| name | String | The name of the guild | |
| prefix | String | The guild's prefix or tag | |
| xp | Number | The total amount of XP earned by the guild | |
| level | Number | The current level of the guild | |
| created | Date | Date that this guild was created | Date in ISO-8601 format with milliseconds |
| banner | Object | (Optional) The banner of the guild | |
| territories | Number | The amount of territories currently owned by the guild | |
| membersCount | Number | The amount of members in the guild | |
| num | Number | The position of this guild in the leaderboard |
Response
{
"data": [
{
"name": String,
"prefix": String,
"xp": Number,
"level": Number,
"created": Date,
"banner": {
"base": String,
"tier": Number,
"layers:" [{
"colour": String,
"pattern": String
},
// ...
]
}
"territories": Number,
"membersCount": Number,
"num": Number // Position number
},
// ...
],
"request": {
"timestamp": Number,
"version": Number
}
}
Player
GET https://api.wynncraft.com/public_api.php?action=statsLeaderboard&type=player&timeframe={timeframe}
Returns a leaderboard of players (represented by an array of player leaderboard objects) with a length of 100. Sorted by player combat level/xp. Timeframe can be alltime.
Player Leaderboard Object
| Field | Type | Description | Options/Details |
|---|---|---|---|
| name | String | The Minecraft username of the player | |
| uuid | String | The Minecraft UUID of the player | |
| kills | Number | The amount of PvP kills this player has | |
| level | Number | Total combat level of the player | |
| xp | Number | The total amount of combat XP earned by the player | |
| minPlayed | Number | The player of the player, in minutes | |
| tag | String | The player's tag | HERO, VIP+, or VIP |
| rank | String | The player's Wynncraft rank | Administrator, Moderator, Builder, Item, Game Master, CMD, Music, Hybrid, Media. Default: Player |
| displayTag | Boolean | Is the player's tag displayed | |
| veteran | String | Is the player a veteran | |
| guildTag | String | (Optional) The tag of the guild that this player is a member of | Not present if the player is not part of a guild |
| guild | String | (Optional) The name of the guild that this player is a member of | Not present if the player is not part of a guild |
| num | Number | The position of the player within the leaderboard |
Response
{
"data": [
{
"name": String,
"uuid": String,
"kills": Number,
"level": Number,
"xp": Number,
"minPlayed": Number,
"tag": String,
"rank": String,
"displayTag": Boolean,
"veteran": Boolean,
"guildTag": String,
"guild": String,
"num": Number // Position number
},
// ...
],
"request": {
"timestamp": Number,
"version": Number
}
}
PvP
GET https://api.wynncraft.com/public_api.php?action=statsLeaderboard&type=pvp&timeframe={timeframe}
Returns a leaderboard of players (represented by an array of player leaderboard objects) with a length of 100. Sorted by PvP kills. Timeframe can be alltime or weekly.
Response
{
"data": [
{
"name": String,
"uuid": String,
"kills": Number,
"level": Number,
"xp": Number,
"minPlayed": Number,
"tag": String,
"rank": String,
"displayTag": Boolean,
"veteran": Boolean,
"guildTag": String,
"guild": String,
"num": Number // Position number
},
// ...
],
"request": {
"timestamp": Number,
"version": Number
}
}