{"openapi":"3.1.0","info":{"title":"Wynncraft API","version":"1.0.0","description":"Wynncraft — the largest Minecraft MMORPG — as an API, from the official Wynncraft API. Look up any player by username for their support rank, total playtime, current guild, and full global stats: total combined level, mobs killed, chests found, completed quests, wars, dungeons, raids and PvP kills/deaths. Pull any guild by name or prefix with its level, member count and roster by rank, owned territories, war count and creation date. Read the live leaderboards (total combined level, guild level, guild territories, combat level, war completions and each gathering profession like mining, fishing and woodcutting), search the full item database for weapons, armour, accessories and ingredients with their tier/rarity, type, level and class requirement, elements, powder slots and major ids, browse the five playable classes, and get a class\\x27s ability-tree size. Perfect for Wynncraft companion apps, guild and player trackers, item and build tools, leaderboards and Discord bots. No accounts, no upstream key.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wynncraft-api","description":"oanor gateway"}],"tags":[{"name":"Players"},{"name":"Guilds"},{"name":"Leaderboards"},{"name":"Items"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/player":{"get":{"operationId":"get_v1_player","tags":["Players"],"summary":"Player profile & stats","description":"","parameters":[{"name":"username","in":"query","required":true,"description":"Minecraft username","schema":{"type":"string"},"example":"Salted"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"player":{"rank":"champion","uuid":"1ed075fc-5aa9-42e0-a29f-640326c1d80c","guild":{"name":"Wynncraft","rank":"OWNER","prefix":"WYNN"},"stats":{"pvp":{"kills":23,"deaths":18},"wars":7,"raids":1,"dungeons":19,"mobs_killed":6993,"total_level":1562,"chests_found":411,"completed_quests":38},"online":false,"veteran":true,"playtime":12843.17,"username":"Salted","last_join":"2026-05-31T23:42:31.916000Z","first_join":"2013-03-27T13:10:34.000000Z"}},"meta":{"timestamp":"2026-06-01T00:03:29.092Z","request_id":"9ed3c7c6-0f5c-4ae7-b93a-3153ae8a491e"},"status":"ok","message":"Player retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/guild":{"get":{"operationId":"get_v1_guild","tags":["Guilds"],"summary":"Guild by name/prefix","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Guild name","schema":{"type":"string"},"example":"Avicia"},{"name":"prefix","in":"query","required":false,"description":"Guild prefix","schema":{"type":"string"},"example":"AVO"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"guild":{"name":"Avicia","uuid":"00ccf9d3-6670-4cd7-a447-f7fec684129d","wars":221390,"level":129,"online":13,"prefix":"AVO","created":"2018-08-01T16:40:45.322000Z","xp_percent":33,"banner_tier":8,"territories":52,"members_total":149,"members_by_rank":{"chief":28,"owner":1,"captain":59,"recruit":6,"recruiter":32,"strategist":23}}},"meta":{"timestamp":"2026-06-01T00:03:29.328Z","request_id":"d81926cf-9c5a-423a-ad3d-d8b99b2e0571"},"status":"ok","message":"Guild retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/leaderboard":{"get":{"operationId":"get_v1_leaderboard","tags":["Leaderboards"],"summary":"A ranked leaderboard","description":"","parameters":[{"name":"type","in":"query","required":false,"description":"Leaderboard type","schema":{"type":"string"},"example":"totalGlobalLevel"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"totalGlobalLevel","count":20,"leaderboard":[{"xp":100456382524,"name":"redacted","rank":1,"uuid":"redacted","score":25571,"playtime":12872.83},{"xp":10935813809,"name":"Krokofant","rank":2,"uuid":"7181f903-7849-49b4-9d5c-2f94ecb67313","score":24522,"playtime":16107.5},{"xp":3904806923,"name":"Rexshell","rank":3,"uuid":"63fac5fc-806d-419a-b715-c1e7c60f3ebb","score":24166,"playtime":12961.33},{"xp":1303739906,"name":"conniesunshine","rank":4,"uuid":"0026e281-0f15-45d8-a9fa-6bd40ad6681b","score":23469,"playtime":6706.17},{"xp":6432285546,"name":"nasiuduk","rank":5,"uuid":"3653daf4-be1f-418c-a71c-bfc88c3a9387","score":23282,"playtime":4375},{"xp":18540459528,"name":"Tannslee","rank":6,"uuid":"cc93d0cd-5c73-4dde-bb0f-f65902cf9c89","score":22877,"playtime":6346.33},{"xp":10017473768,"name":"NOMOREWORRY","rank":7,"uuid":"94ca1941-e8ba-4343-873d-74c9ef1a2c77","score":22590,"playtime":3768.42},{"xp":288402226800,"name":"koprr","rank":8,"uuid":"72250a1d-144c-48d8-8223-1209ffcaf82d","score":22486,"playtime":9092.67},{"xp":3219468282,"name":"littlecat0214","rank":9,"uuid":"d34764bf-38bd-4317-b7d6-dd71cf94271b","score":22020,"playtime":3588.25},{"xp":2775586239,"name":"VHoltz_","rank":10,"uuid":"b1b8d770-62a4-44e5-a6e8-68d8c7104ce8","score":21877,"playtime":13939.83},{"xp":6598519609,"name":"redacted","rank":11,"uuid":"redacted","score":21298,"playtime":7687.5},{"xp":12540405635,"name":"AndrQwQ","rank":12,"uuid":"6aa878c1-7f7e-461f-9ab3-a4ad74461a3e","score":21142,"playtime":6595.67},{"xp":1232000428,"name":"YanPawa","rank":13,"uuid":"4a204f9a-8631-4be6-8e95-2fedad388d0e","score":21057,"playtime":3956.33},{"xp":2148139959,"name":"_Pain_Less_","rank":14,"uuid":"2c87d3a3-833f-446f-a375-65ba151a26ae","score":21001,"playtime":13215.17},{"xp":28511062500,"name":"Calluum","rank":15,"uuid":"911a950a-839d-4150-bfe8-d901a3b85316","score":20976,"playtime":36793.17},{"xp":6095473651,"name":"redacted","rank":16,"uuid":"redacted","score":20899,"playtime":9423.25},{"xp":6888562514,"name":"SleepingXor","rank":17,"uuid":"fce8af4e-4a1b-44c2-b134-097c303de57e","score":20809,"playtime":6153.83},{"xp":3578341456,"name":"GebutterteWurst","rank":18,"uuid":"5c46332e-b1ec-4c4a-9a59-4bf2a4a8baaa","score":20350,"playtime":13686.92},{"xp":16935485131,"name":"redacted","rank":19,"uuid":"redacted","score":20131,"playtime":4683.92},{"xp":411801687,"name":"ChefMad","rank":20,"uuid":"7b261d99-855b-4e0c-850a-4b16fcf7c676","score":19719,"playtime":10780.67}]},"meta":{"timestamp":"2026-06-01T00:03:29.566Z","request_id":"4dc3e1c1-f0bb-475b-9f64-6b6029b7416a"},"status":"ok","message":"Leaderboard retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/item":{"get":{"operationId":"get_v1_item","tags":["Items"],"summary":"Search the item database","description":"","parameters":[{"name":"query","in":"query","required":true,"description":"Item name","schema":{"type":"string"},"example":"Idol"},{"name":"limit","in":"query","required":false,"description":"Max 1-50","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"items":[{"name":"Weathered Idol","type":"ingredient","level":36,"rarity":"TIER_3","elements":[],"major_ids":[]},{"drop":"Aerie of the Recluse","name":"Eidolon","type":"weapon","level":95,"rarity":"rare","elements":["air"],"sub_type":"wand","class_req":"mage","major_ids":[],"average_dps":280,"attack_speed":"superSlow","powder_slots":5},{"drop":"normal","name":"False Idol","type":"armour","level":37,"rarity":"fabled","elements":["earth","thunder"],"sub_type":"helmet","major_ids":["Sun Eater"],"powder_slots":2},{"drop":"never","name":"Pareidolia","type":"weapon","level":102,"rarity":"legendary","elements":["air","thunder","water"],"sub_type":"relik","class_req":"shaman","major_ids":[],"average_dps":798,"attack_speed":"veryFast","powder_slots":2},{"drop":"normal","name":"Idol","type":"weapon","level":95,"rarity":"mythic","elements":["water"],"sub_type":"spear","class_req":"warrior","major_ids":["Tidal Drift"],"average_dps":533,"attack_speed":"normal","powder_slots":3},{"name":"Illusory Idol","type":"ingredient","level":84,"rarity":"TIER_2","elements":[],"major_ids":[]}],"query":"Idol","total":6},"meta":{"timestamp":"2026-06-01T00:03:29.764Z","request_id":"5ad057fb-3b12-4abf-bb1c-01fd7782e057"},"status":"ok","message":"Items retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/abilities":{"get":{"operationId":"get_v1_abilities","tags":["Reference"],"summary":"A class ability tree","description":"","parameters":[{"name":"class","in":"query","required":true,"description":"archer|warrior|assassin|mage|shaman","schema":{"type":"string"},"example":"archer"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"class":"archer","pages":9,"ability_ids":["arrowbomb","bowProficiency","arrowBombCost1","directHit","hastyShots","escape","powerShots","arrowstorm","escapeCost1","arrowshield","windyfeet","archerAirPath","archerThunderPath","archerFirePath","archerWaterPath","archerEarthPath","arrowrain","nimbleString","mossyArrowStorm","fireCreep","phantomDarts","hitToRename","tripleShots","guardianAngels","explodingTrap","focus","windstorm","arrowStormCost1","implosion","tripleshield","betterWindyFeet","arsenalSynergy","timeBomb","grapplingHook","moreFocus","murderFlock","arrowBombDamage1","phantomForce","leap","grapeBomb","ivyrootMamba","concentration","shrapnelBomb","fierceStomp","rocketJump","scorchedEarth","moreTraps1","divineIntervention","arrowShieldCost1","betterArrowShield"],"ability_count":97},"meta":{"timestamp":"2026-06-01T00:03:29.979Z","request_id":"190c7b15-b192-4a85-b901-7bcbb62e29c7"},"status":"ok","message":"Abilities retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/classes":{"get":{"operationId":"get_v1_classes","tags":["Reference"],"summary":"The five classes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":5,"classes":[{"id":"archer","name":"Archer (Hunter)","overall_difficulty":1},{"id":"warrior","name":"Warrior (Knight)","overall_difficulty":2},{"id":"assassin","name":"Assassin (Ninja)","overall_difficulty":2},{"id":"mage","name":"Mage (Dark Wizard)","overall_difficulty":1},{"id":"shaman","name":"Shaman (Skyseer)","overall_difficulty":3}]},"meta":{"timestamp":"2026-06-01T00:03:30.156Z","request_id":"3521bab1-76f5-40be-a3a1-2f17542447ee"},"status":"ok","message":"Classes retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Wynncraft (the Minecraft MMORPG). /v1/player?username=Salted = a player's rank, playtime, guild and global stats (total level, mobs killed, chests, quests, wars, PvP); /v1/guild?name=Avicia (or prefix=AVO) = a guild's level, members, territories & wars; /v1/leaderboard?type=totalGlobalLevel = a ranked leaderboard (also guildLevel, combatGlobalLevel, warsCompletion, mining/fishing/woodcuttingLevel, …); /v1/item?query=Idol = search the item database (type, rarity, level & class requirement); /v1/classes = the five classes; /v1/abilities?class=archer = a class's ability tree. Official Wynncraft data.","source":"Wynncraft official API (api.wynncraft.com)","endpoints":["/v1/player","/v1/guild","/v1/leaderboard","/v1/item","/v1/classes","/v1/abilities","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:03:30.221Z","request_id":"a8097eec-0763-40e1-8f00-2eeb88240746"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3450,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":450,"monthly_call_quota":45500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1410,"monthly_call_quota":219000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3920,"monthly_call_quota":1095000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wynncraft-api"}