{"openapi":"3.1.0","info":{"title":"Pangolin Works public game API","version":"2026-10-20","description":"One successful data GET per 300 seconds per IP across all routes; IPv6 grouped by /64. No query parameters. Cache snapshots in your application."},"servers":[{"url":"https://api.pangolinworks.dev"}],"paths":{"/blast-buddies":{"get":{"summary":"Get the complete Blast Buddies snapshot","responses":{"200":{"description":"Snapshot refreshed every 300 seconds; stale after 600 seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["generatedAt","metadata","ranked","leaderboards","clans","catalog"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","required":["ageSeconds","stale"],"properties":{"ageSeconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"game":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"refreshIntervalSeconds":{"type":"number","minimum":0},"limits":{"type":"object","properties":{"ranked":{"type":"number","minimum":0},"daily":{"type":"number","minimum":0},"weekly":{"type":"number","minimum":0},"clans":{"type":"number","minimum":0},"clanArchiveMonths":{"type":"number","minimum":0},"clanArchiveTop":{"type":"number","minimum":0}},"required":["ranked","daily","weekly","clans","clanArchiveMonths","clanArchiveTop"]},"statsScope":{"type":"string"},"historyNote":{"type":"string"},"resetNote":{"type":"string"},"tieNote":{"type":"string"},"resetSchedule":{"type":"object","properties":{"daily":{"type":"string"},"weekly":{"type":"string"},"clans":{"type":"string"}},"required":["daily","weekly","clans"]}},"additionalProperties":true},"ranked":{"type":"object","properties":{"current":{"type":"object","properties":{"season":{"type":"number","minimum":0},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","trophies","rankedWins","rankedLosses"]}}},"required":["season","top"]},"archives":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"available":{"type":"boolean"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"playerId":{"type":"string"},"name":{"type":"string"}},"required":["rank","trophies","rankedWins","rankedLosses","characterSkinId","playerId","name"]}}},"required":["season","available","top"]}}},"required":["current","archives"]},"leaderboards":{"type":"object","properties":{"daily":{"type":"object","properties":{"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","kills","deaths","assists"]}}},"required":["top"]},"weekly":{"type":"object","properties":{"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","kills","deaths","assists"]}}},"required":["top"]}},"required":["daily","weekly"]},"clans":{"type":"object","properties":{"period":{"type":"string"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"color":{"type":"number","minimum":0},"memberCount":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"clanId":{"type":"string"},"name":{"type":"string"},"tag":{"type":"string"},"memberCap":{"type":"number","minimum":0},"openJoin":{"type":"boolean"}},"required":["rank","color","memberCount","kills","clanId","name","tag","memberCap","openJoin"]}},"archives":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"color":{"type":"number","minimum":0},"memberCount":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"clanId":{"type":"string"},"name":{"type":"string"},"tag":{"type":"string"},"members":{"type":"array","items":{"type":"object","properties":{"playerId":{"type":"string"},"name":{"type":"string"},"level":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"isLeader":{"type":"boolean"}},"required":["playerId","name","level","kills","characterSkinId","topWeaponId","topWeaponSkinId","isLeader"]}}},"required":["rank","color","memberCount","kills","clanId","name","tag","members"]}}},"required":["period","top"]}}},"required":["period","top","archives"]},"catalog":{"type":"object","properties":{"game":{"type":"string"},"sourceCommit":{"type":"string"},"definitionsNote":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"divisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"name":{"type":"string"},"minTrophies":{"type":"number","minimum":0},"maxTrophies":{"type":["number","null"]},"color":{"type":"string"},"hasSubTiers":{"type":"boolean"}},"required":["id","name","minTrophies","maxTrophies","color","hasSubTiers"]}},"clanColors":{"type":"array","items":{"type":"string"}},"levels":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number","minimum":0},"xpRequired":{"type":"number","minimum":0}},"required":["level","xpRequired"]}},"maps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"name":{"type":"string"},"modes":{"type":"array","items":{"type":"string"}},"playerCount":{"type":"number","minimum":0},"imgPath":{"type":"string"}},"required":["id","name","modes","playerCount","imgPath"]}},"weapons":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"category":{"type":"number","minimum":0},"rarity":{"type":"number","minimum":0},"critMultiplier":{"type":"number","minimum":0},"limbMultiplier":{"type":"number","minimum":0},"movement":{"type":"number","minimum":0},"fireRate":{"type":"number","minimum":0},"reloadTime":{"type":"number","minimum":0},"magazineSize":{"type":"number","minimum":0},"pellets":{"type":"number","minimum":0},"name":{"type":"string"},"imagePath":{"type":"string"},"damageRanges":{"type":"array","items":{"type":"object","properties":{"distance":{"type":"number","minimum":0},"damage":{"type":"number","minimum":0}},"required":["distance","damage"]}},"scope":{"type":"boolean"}},"required":["id","category","rarity","critMultiplier","limbMultiplier","movement","fireRate","reloadTime","magazineSize","name","imagePath","damageRanges","scope"]}},"abilities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"cooldown":{"type":"number","minimum":0},"duration":{"type":"number","minimum":0},"levelRequired":{"type":"number","minimum":0},"maxCharges":{"type":"number","minimum":0},"name":{"type":"string"},"description":{"type":"string"},"icon":{"type":"string"}},"required":["id","cooldown","duration","levelRequired","maxCharges","name","description","icon"]}}},"required":["game","sourceCommit","definitionsNote","currentSeason","divisions","clanColors","levels","maps","weapons","abilities"]}}}}}},"400":{"description":"Query parameters or invalid client address","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Shared IP budget exhausted or limiter capacity reached","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"No snapshot younger than 1800 seconds","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/blast-buddies/snapshot":{"get":{"summary":"Get the complete Blast Buddies snapshot","responses":{"200":{"description":"Snapshot refreshed every 300 seconds; stale after 600 seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["generatedAt","metadata","ranked","leaderboards","clans","catalog"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","required":["ageSeconds","stale"],"properties":{"ageSeconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"game":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"refreshIntervalSeconds":{"type":"number","minimum":0},"limits":{"type":"object","properties":{"ranked":{"type":"number","minimum":0},"daily":{"type":"number","minimum":0},"weekly":{"type":"number","minimum":0},"clans":{"type":"number","minimum":0},"clanArchiveMonths":{"type":"number","minimum":0},"clanArchiveTop":{"type":"number","minimum":0}},"required":["ranked","daily","weekly","clans","clanArchiveMonths","clanArchiveTop"]},"statsScope":{"type":"string"},"historyNote":{"type":"string"},"resetNote":{"type":"string"},"tieNote":{"type":"string"},"resetSchedule":{"type":"object","properties":{"daily":{"type":"string"},"weekly":{"type":"string"},"clans":{"type":"string"}},"required":["daily","weekly","clans"]}},"additionalProperties":true},"ranked":{"type":"object","properties":{"current":{"type":"object","properties":{"season":{"type":"number","minimum":0},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","trophies","rankedWins","rankedLosses"]}}},"required":["season","top"]},"archives":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"available":{"type":"boolean"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"playerId":{"type":"string"},"name":{"type":"string"}},"required":["rank","trophies","rankedWins","rankedLosses","characterSkinId","playerId","name"]}}},"required":["season","available","top"]}}},"required":["current","archives"]},"leaderboards":{"type":"object","properties":{"daily":{"type":"object","properties":{"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","kills","deaths","assists"]}}},"required":["top"]},"weekly":{"type":"object","properties":{"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","kills","deaths","assists"]}}},"required":["top"]}},"required":["daily","weekly"]},"clans":{"type":"object","properties":{"period":{"type":"string"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"color":{"type":"number","minimum":0},"memberCount":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"clanId":{"type":"string"},"name":{"type":"string"},"tag":{"type":"string"},"memberCap":{"type":"number","minimum":0},"openJoin":{"type":"boolean"}},"required":["rank","color","memberCount","kills","clanId","name","tag","memberCap","openJoin"]}},"archives":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"color":{"type":"number","minimum":0},"memberCount":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"clanId":{"type":"string"},"name":{"type":"string"},"tag":{"type":"string"},"members":{"type":"array","items":{"type":"object","properties":{"playerId":{"type":"string"},"name":{"type":"string"},"level":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"isLeader":{"type":"boolean"}},"required":["playerId","name","level","kills","characterSkinId","topWeaponId","topWeaponSkinId","isLeader"]}}},"required":["rank","color","memberCount","kills","clanId","name","tag","members"]}}},"required":["period","top"]}}},"required":["period","top","archives"]},"catalog":{"type":"object","properties":{"game":{"type":"string"},"sourceCommit":{"type":"string"},"definitionsNote":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"divisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"name":{"type":"string"},"minTrophies":{"type":"number","minimum":0},"maxTrophies":{"type":["number","null"]},"color":{"type":"string"},"hasSubTiers":{"type":"boolean"}},"required":["id","name","minTrophies","maxTrophies","color","hasSubTiers"]}},"clanColors":{"type":"array","items":{"type":"string"}},"levels":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number","minimum":0},"xpRequired":{"type":"number","minimum":0}},"required":["level","xpRequired"]}},"maps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"name":{"type":"string"},"modes":{"type":"array","items":{"type":"string"}},"playerCount":{"type":"number","minimum":0},"imgPath":{"type":"string"}},"required":["id","name","modes","playerCount","imgPath"]}},"weapons":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"category":{"type":"number","minimum":0},"rarity":{"type":"number","minimum":0},"critMultiplier":{"type":"number","minimum":0},"limbMultiplier":{"type":"number","minimum":0},"movement":{"type":"number","minimum":0},"fireRate":{"type":"number","minimum":0},"reloadTime":{"type":"number","minimum":0},"magazineSize":{"type":"number","minimum":0},"pellets":{"type":"number","minimum":0},"name":{"type":"string"},"imagePath":{"type":"string"},"damageRanges":{"type":"array","items":{"type":"object","properties":{"distance":{"type":"number","minimum":0},"damage":{"type":"number","minimum":0}},"required":["distance","damage"]}},"scope":{"type":"boolean"}},"required":["id","category","rarity","critMultiplier","limbMultiplier","movement","fireRate","reloadTime","magazineSize","name","imagePath","damageRanges","scope"]}},"abilities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"cooldown":{"type":"number","minimum":0},"duration":{"type":"number","minimum":0},"levelRequired":{"type":"number","minimum":0},"maxCharges":{"type":"number","minimum":0},"name":{"type":"string"},"description":{"type":"string"},"icon":{"type":"string"}},"required":["id","cooldown","duration","levelRequired","maxCharges","name","description","icon"]}}},"required":["game","sourceCommit","definitionsNote","currentSeason","divisions","clanColors","levels","maps","weapons","abilities"]}}}}}},"400":{"description":"Query parameters or invalid client address","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Shared IP budget exhausted or limiter capacity reached","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"No snapshot younger than 1800 seconds","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/blast-buddies/ranked":{"get":{"summary":"Get public ranked","responses":{"200":{"description":"Snapshot refreshed every 300 seconds; stale after 600 seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["generatedAt","metadata","ranked"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","required":["ageSeconds","stale"],"properties":{"ageSeconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"game":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"refreshIntervalSeconds":{"type":"number","minimum":0},"limits":{"type":"object","properties":{"ranked":{"type":"number","minimum":0},"daily":{"type":"number","minimum":0},"weekly":{"type":"number","minimum":0},"clans":{"type":"number","minimum":0},"clanArchiveMonths":{"type":"number","minimum":0},"clanArchiveTop":{"type":"number","minimum":0}},"required":["ranked","daily","weekly","clans","clanArchiveMonths","clanArchiveTop"]},"statsScope":{"type":"string"},"historyNote":{"type":"string"},"resetNote":{"type":"string"},"tieNote":{"type":"string"},"resetSchedule":{"type":"object","properties":{"daily":{"type":"string"},"weekly":{"type":"string"},"clans":{"type":"string"}},"required":["daily","weekly","clans"]}},"additionalProperties":true},"ranked":{"type":"object","properties":{"current":{"type":"object","properties":{"season":{"type":"number","minimum":0},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","trophies","rankedWins","rankedLosses"]}}},"required":["season","top"]},"archives":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"available":{"type":"boolean"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"playerId":{"type":"string"},"name":{"type":"string"}},"required":["rank","trophies","rankedWins","rankedLosses","characterSkinId","playerId","name"]}}},"required":["season","available","top"]}}},"required":["current","archives"]}}}}}},"400":{"description":"Query parameters or invalid client address","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Shared IP budget exhausted or limiter capacity reached","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"No snapshot younger than 1800 seconds","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/blast-buddies/leaderboards":{"get":{"summary":"Get public leaderboards","responses":{"200":{"description":"Snapshot refreshed every 300 seconds; stale after 600 seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["generatedAt","metadata","leaderboards"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","required":["ageSeconds","stale"],"properties":{"ageSeconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"game":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"refreshIntervalSeconds":{"type":"number","minimum":0},"limits":{"type":"object","properties":{"ranked":{"type":"number","minimum":0},"daily":{"type":"number","minimum":0},"weekly":{"type":"number","minimum":0},"clans":{"type":"number","minimum":0},"clanArchiveMonths":{"type":"number","minimum":0},"clanArchiveTop":{"type":"number","minimum":0}},"required":["ranked","daily","weekly","clans","clanArchiveMonths","clanArchiveTop"]},"statsScope":{"type":"string"},"historyNote":{"type":"string"},"resetNote":{"type":"string"},"tieNote":{"type":"string"},"resetSchedule":{"type":"object","properties":{"daily":{"type":"string"},"weekly":{"type":"string"},"clans":{"type":"string"}},"required":["daily","weekly","clans"]}},"additionalProperties":true},"leaderboards":{"type":"object","properties":{"daily":{"type":"object","properties":{"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","kills","deaths","assists"]}}},"required":["top"]},"weekly":{"type":"object","properties":{"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"playerId":{"type":"string","description":"Canonical short player ID."},"name":{"type":"string"},"totalXp":{"type":"number","minimum":0},"level":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"clanId":{"type":"string"},"clanTag":{"type":"string"},"clanColor":{"type":["number","null"],"minimum":0},"stats":{"type":"object","properties":{"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0},"games":{"type":"number","minimum":0}},"required":["kills","deaths","assists","games"]},"seasons":{"type":"array","items":{"type":"object","properties":{"season":{"type":"number","minimum":0},"trophies":{"type":"number","minimum":0},"rankedWins":{"type":"number","minimum":0},"rankedLosses":{"type":"number","minimum":0}},"required":["season","trophies","rankedWins","rankedLosses"]}},"weaponStats":{"type":"array","items":{"type":"object","properties":{"weaponId":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"headshots":{"type":"number","minimum":0}},"required":["weaponId","kills","headshots"]}},"kills":{"type":"number","minimum":0},"deaths":{"type":"number","minimum":0},"assists":{"type":"number","minimum":0}},"required":["rank","playerId","name","totalXp","level","characterSkinId","topWeaponId","topWeaponSkinId","clanId","clanTag","clanColor","stats","seasons","weaponStats","kills","deaths","assists"]}}},"required":["top"]}},"required":["daily","weekly"]}}}}}},"400":{"description":"Query parameters or invalid client address","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Shared IP budget exhausted or limiter capacity reached","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"No snapshot younger than 1800 seconds","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/blast-buddies/clans":{"get":{"summary":"Get public clans","responses":{"200":{"description":"Snapshot refreshed every 300 seconds; stale after 600 seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["generatedAt","metadata","clans"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","required":["ageSeconds","stale"],"properties":{"ageSeconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"game":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"refreshIntervalSeconds":{"type":"number","minimum":0},"limits":{"type":"object","properties":{"ranked":{"type":"number","minimum":0},"daily":{"type":"number","minimum":0},"weekly":{"type":"number","minimum":0},"clans":{"type":"number","minimum":0},"clanArchiveMonths":{"type":"number","minimum":0},"clanArchiveTop":{"type":"number","minimum":0}},"required":["ranked","daily","weekly","clans","clanArchiveMonths","clanArchiveTop"]},"statsScope":{"type":"string"},"historyNote":{"type":"string"},"resetNote":{"type":"string"},"tieNote":{"type":"string"},"resetSchedule":{"type":"object","properties":{"daily":{"type":"string"},"weekly":{"type":"string"},"clans":{"type":"string"}},"required":["daily","weekly","clans"]}},"additionalProperties":true},"clans":{"type":"object","properties":{"period":{"type":"string"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"color":{"type":"number","minimum":0},"memberCount":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"clanId":{"type":"string"},"name":{"type":"string"},"tag":{"type":"string"},"memberCap":{"type":"number","minimum":0},"openJoin":{"type":"boolean"}},"required":["rank","color","memberCount","kills","clanId","name","tag","memberCap","openJoin"]}},"archives":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"top":{"type":"array","items":{"type":"object","properties":{"rank":{"type":"number","minimum":0},"color":{"type":"number","minimum":0},"memberCount":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"clanId":{"type":"string"},"name":{"type":"string"},"tag":{"type":"string"},"members":{"type":"array","items":{"type":"object","properties":{"playerId":{"type":"string"},"name":{"type":"string"},"level":{"type":"number","minimum":0},"kills":{"type":"number","minimum":0},"characterSkinId":{"type":"number","minimum":0},"topWeaponId":{"type":"number","minimum":0},"topWeaponSkinId":{"type":"number","minimum":0},"isLeader":{"type":"boolean"}},"required":["playerId","name","level","kills","characterSkinId","topWeaponId","topWeaponSkinId","isLeader"]}}},"required":["rank","color","memberCount","kills","clanId","name","tag","members"]}}},"required":["period","top"]}}},"required":["period","top","archives"]}}}}}},"400":{"description":"Query parameters or invalid client address","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Shared IP budget exhausted or limiter capacity reached","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"No snapshot younger than 1800 seconds","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}},"/blast-buddies/catalog":{"get":{"summary":"Get public catalog","responses":{"200":{"description":"Snapshot refreshed every 300 seconds; stale after 600 seconds.","headers":{"RateLimit-Limit":{"schema":{"type":"integer"}},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["generatedAt","metadata","catalog"],"properties":{"generatedAt":{"type":"string","format":"date-time"},"metadata":{"type":"object","required":["ageSeconds","stale"],"properties":{"ageSeconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"game":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"refreshIntervalSeconds":{"type":"number","minimum":0},"limits":{"type":"object","properties":{"ranked":{"type":"number","minimum":0},"daily":{"type":"number","minimum":0},"weekly":{"type":"number","minimum":0},"clans":{"type":"number","minimum":0},"clanArchiveMonths":{"type":"number","minimum":0},"clanArchiveTop":{"type":"number","minimum":0}},"required":["ranked","daily","weekly","clans","clanArchiveMonths","clanArchiveTop"]},"statsScope":{"type":"string"},"historyNote":{"type":"string"},"resetNote":{"type":"string"},"tieNote":{"type":"string"},"resetSchedule":{"type":"object","properties":{"daily":{"type":"string"},"weekly":{"type":"string"},"clans":{"type":"string"}},"required":["daily","weekly","clans"]}},"additionalProperties":true},"catalog":{"type":"object","properties":{"game":{"type":"string"},"sourceCommit":{"type":"string"},"definitionsNote":{"type":"string"},"currentSeason":{"type":"number","minimum":0},"divisions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"name":{"type":"string"},"minTrophies":{"type":"number","minimum":0},"maxTrophies":{"type":["number","null"]},"color":{"type":"string"},"hasSubTiers":{"type":"boolean"}},"required":["id","name","minTrophies","maxTrophies","color","hasSubTiers"]}},"clanColors":{"type":"array","items":{"type":"string"}},"levels":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number","minimum":0},"xpRequired":{"type":"number","minimum":0}},"required":["level","xpRequired"]}},"maps":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"name":{"type":"string"},"modes":{"type":"array","items":{"type":"string"}},"playerCount":{"type":"number","minimum":0},"imgPath":{"type":"string"}},"required":["id","name","modes","playerCount","imgPath"]}},"weapons":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"category":{"type":"number","minimum":0},"rarity":{"type":"number","minimum":0},"critMultiplier":{"type":"number","minimum":0},"limbMultiplier":{"type":"number","minimum":0},"movement":{"type":"number","minimum":0},"fireRate":{"type":"number","minimum":0},"reloadTime":{"type":"number","minimum":0},"magazineSize":{"type":"number","minimum":0},"pellets":{"type":"number","minimum":0},"name":{"type":"string"},"imagePath":{"type":"string"},"damageRanges":{"type":"array","items":{"type":"object","properties":{"distance":{"type":"number","minimum":0},"damage":{"type":"number","minimum":0}},"required":["distance","damage"]}},"scope":{"type":"boolean"}},"required":["id","category","rarity","critMultiplier","limbMultiplier","movement","fireRate","reloadTime","magazineSize","name","imagePath","damageRanges","scope"]}},"abilities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","minimum":0},"cooldown":{"type":"number","minimum":0},"duration":{"type":"number","minimum":0},"levelRequired":{"type":"number","minimum":0},"maxCharges":{"type":"number","minimum":0},"name":{"type":"string"},"description":{"type":"string"},"icon":{"type":"string"}},"required":["id","cooldown","duration","levelRequired","maxCharges","name","description","icon"]}}},"required":["game","sourceCommit","definitionsNote","currentSeason","divisions","clanColors","levels","maps","weapons","abilities"]}}}}}},"400":{"description":"Query parameters or invalid client address","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"429":{"description":"Shared IP budget exhausted or limiter capacity reached","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}},"503":{"description":"No snapshot younger than 1800 seconds","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Minimum seconds before retrying."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}}}}}}}}}