Wynncraft

About Wynncraft

The Wynncraft API is a public REST API (v3) providing access to game, player, guild, item, leaderboard, map, and news data for the Minecraft server Wynncraft. It is documented at a base URL of https://api.wynncraft.com/v3 and includes endpoints for player profiles and characters, guild information, item and recipe databases, class abilities, map markers and events, leaderboards, and published news articles. Authentication is supported via OAuth2, including application creation and token-based access, with a separate Dev Discord for changelog announcements.

Responses include standard HTTP headers for caching, rate limiting, and versioning, with GET requests cached using route-specific TTLs and either user-specific or shared cache sources. Rate limits are tracked per bucket (SHARED, PLAYER, GUILD, ITEMS, LEADERBOARDS, MAP), with higher limits for authenticated requests (120 requests per minute) than for guest requests (50 requests per minute). Errors follow a common JSON format, and queries that match multiple resources return a MultipleObjectsReturned response.

The API also includes a markup parser for rendered in-game text formatting (fonts, colors, text decoration) and serves media assets, such as fonts, from a CDN at https://cdn.wynncraft.com/nextgen. It is intended for developers building applications or tools that read Wynncraft game data, and previous API versions (v1 and v2) are deprecated in favor of v3.

Key features

• Read public game, player, guild, item, leaderboard, map, and news data via REST API
• OAuth2 authentication for player, guild, and application access
• Search and list item and recipe database entries
• Guild, territory, and leaderboard endpoints
• Map data including markers, player locations, world events, raids, and loot pools
• Rate-limited requests with per-bucket limits, higher for authenticated calls

Frequently asked questions