Wynncraft API

Free Wynncraft API with no key: player stats, guild data, item database, leaderboards and live server player counts for the Minecraft MMORPG. Tested example included.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-21

What is the Wynncraft API?

The Wynncraft API is the official, key-free HTTP API for the Wynncraft Minecraft MMORPG. It exposes player profiles and class stats, guild membership and territory control, the full item and ingredient database, leaderboards and live server population.

Wynncraft is the largest MMORPG built inside Minecraft, and unusually for a Minecraft server it runs a properly designed public API. The v3 API is versioned, documented and stable, which is why the game's community tooling — build planners, guild dashboards, territory maps — is unusually mature.

The endpoint shown below is the leaderboard type index, and it is a good place to start because it tells you what the API can rank rather than assuming you know: guild levels, territory counts, war totals, per-profession levels, raid completions and a long tail of ironman and hardcore variants. Fetch it once and you have the vocabulary for every subsequent leaderboard call.

Quick facts

Base URL: https://api.wynncraft.com/v3
Authentication: No API key or account. The v3 API is public and the previous v2 API is deprecated — new integrations should target v3.
Rate limit: Per-IP limits reported in `RateLimit-*` response headers; roughly 180 requests per minute for anonymous callers.
Pricing: Free.
CORS: Not enabled — call it from your server
Official docs: Read the docs

How to use the Wynncraft API

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

1. List every available leaderboard type

GET https://api.wynncraft.com/v3/leaderboards/types

curl

curl 'https://api.wynncraft.com/v3/leaderboards/types'

JavaScript (fetch)

const res = await fetch("https://api.wynncraft.com/v3/leaderboards/types");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

Python (requests)

import requests

res = requests.get("https://api.wynncraft.com/v3/leaderboards/types", timeout=20)
res.raise_for_status()
print(res.json())

Response — HTTP 200 (truncated)

[
  "guildLevel",
  "guildTerritories",
  "guildWars",
  "professionsGlobalLevel",
  "combatGlobalLevel",
  "totalGlobalLevel",
  "playerContent",
  "combatSoloLevel",
  "professionsSoloLevel",
  "totalSoloLevel",
  "globalPlayerContent",
  "woodcuttingLevel",
  "miningLevel",
  "fishingLevel",
  "farmingLevel",
  "alchemismLevel",
  "armouringLevel",
  "cookingLevel",
  "jewelingLevel",
  "scribingLevel",
  "tailoringLevel",
  "weaponsmithingLevel",
  "woodworkingLevel",
  "huntedContent",
  "grootslangCompletion",
  "colossusCompletion",
  "orphionCompletion",
  "namelessCompletion",
  "warsCompletion",
  "craftsmanContent",
  "huicContent",
  "ironmanContent",
  "ultimateIronmanContent",
  "hardcoreLegacyLevel",
  "hardcoreContent",
  "huichContent",
  "hicContent",
  "hichContent",
  "grootslangSrPlayers",
  "namelessSrPlayers",
  "colossusSrGuilds",
  "colossusSrPlayers",
  "namelessSrGuilds",
  "orphionSrPlayers",
  "grootslangSrGuilds",
  "orphionSrGuilds",
  "frumaCompletion",
  "guildTotalRaids",
  "frumaSrPlayers",
  "frumaSrGuilds",
  "orphionSrGPlayers",
  "namelessSrGPlayers",
  "colossusSrGPlayers",
  "frumaSrGPlayers",
  "grootslangSrGPlayers",
  "guildSeason30",
  "guildSeason29",
  "guildSeason28",
  "guildSeason27",
  "guildSeason26",
  "guildSeason25",
  "guildSeason24",
  "guildSeason23",
  "guildSeason22",
  "guildSeason21",
  "guildSeason20",
  "guildSeason19",
  "guildSeason18",
  "guildSeason17",
  "guildSeason16",
  "guildSeason15",
  "guildSeason14",
  "guildSeason13",
  "guildSeason12",
  "guildSeason11",
  "guildSeason10",
  "guildSeason9",
  "gu

Parameters

Parameter	Type	Required	Description
`resultLimit`	query	Optional	How many entries a leaderboard returns. `10`
`fullResult`	query	Optional	On player and guild endpoints, return the complete object rather than a summary. `true`
`identifier`	query	Optional	On player endpoints, whether to interpret the path as a `username` or a `uuid`. `username`

Response fields

(array of strings)array: The leaderboard type index returns a bare JSON array of type names — pass any of them to the leaderboard endpoint.
guildLevel / guildTerritories / guildWarsstring: Guild-scoped rankings by level, territories currently held and total wars fought.
combatGlobalLevel / totalGlobalLevelstring: Player rankings by combat level and by combined level across all professions.
profession levelsstring: One entry per gathering and crafting profession — mining, fishing, woodcutting, farming, alchemism, armouring, cooking, jeweling, scribing, tailoring, weaponsmithing, woodworking.
raid completionsstring: Completion counts for Grootslang, Colossus, Orphion and Nameless.
ironman / hardcore variantsstring: Parallel leaderboards restricted to ironman, ultimate ironman, hardcore and craftsman characters.

What you can build with the Wynncraft API

Build a guild dashboard showing member levels and territory holdings
Show live server population and player counts on a community site
Look up a player's classes, quests and raid completions from a Discord bot
Power an item search or build planner from the item database

Common errors and how to fix them

404

Unknown player, guild or leaderboard type.

Fix: Player lookups accept a username or a UUID — set `identifier` to say which. Guild names are case-sensitive; the prefix endpoint is more forgiving.

429

Rate limit exceeded.

Fix: Read the `RateLimit-Remaining` and `RateLimit-Reset` headers and pause accordingly. Leaderboards change slowly, so cache them for minutes rather than seconds.

300

An ambiguous player lookup matched more than one account.

Fix: The response body lists the candidate UUIDs — pick one and re-request by UUID.

Wynncraft API — frequently asked questions

Is the Wynncraft API free and does it need a key?

Yes, it is free and needs no API key or account. The current version is v3; the older v2 API is deprecated and new integrations should not target it.

What data does the Wynncraft API expose?

Player profiles with per-class stats, quests and raid completions; guild membership, level and territory control; the full item and ingredient database; leaderboards across dozens of categories; and live server population by world.

How do I look up a Wynncraft player?

Call the player endpoint with a username and `identifier=username`, or pass a Minecraft UUID with `identifier=uuid`. UUID is more reliable, since usernames can be changed by their owners.

Are there rate limits?

Yes — roughly 180 requests per minute per IP, reported in `RateLimit-*` response headers. Cache leaderboard and item data, which changes far more slowly than the limit implies.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

JSON to CSV Converter

Convert a JSON array of objects to CSV online. Automatic column headers from the union of all keys, delimiter choice and proper quoting — all in-browser.

UUID Generator

Generate 1–100 cryptographically random UUID v4 identifiers at once. Uppercase and hyphen-less options, per-item copy and copy-all. Free UUID generator.

Wynncraft is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-21; always check the official documentation before relying on this API in production, as terms and limits can change.