Public API
All endpoints are read-only, CORS-enabled, and free to use. Build Discord bots, overlays, spreadsheets, or any tool on top of shared builds.
Base URL: https://gms-upgrade-tracker.vercel.app
All responses are JSON. No authentication required. Rate limits are generous (Vercel serverless defaults). Players must save their build on the website before it can be accessed via API.
Builds
/api/share?id={IGN}Fetch a shared build by character name. Returns full gear, stats, class, server type, and Nexon region.
Parameters:
region(string, default: na)Optional Nexon region for build lookup: na or euResponse:
{ id, selectedClass, serverType, nexonRegion, characterStats, gear }/api/build/{IGN}/summaryGet a summary of a build including power score, gear overview, and set effects.
Parameters:
region(string, default: na)Optional Nexon region for build lookup: na or euResponse:
{ buildId, class, serverType, nexonRegion, powerScore, gear }/api/build/{IGN}/recommendGet upgrade recommendations ranked by meso efficiency. Supports query params for limit, mesoRate, sfDiscount, feverTime, cubeSale.
Parameters:
limit(int, default: 5)Number of recommendations (1-20)mesoRate(int, default: 300000)Meso market rate (meso per NX)sfDiscount(bool, default: false)Star Force 30% discount eventfeverTime(bool, default: false)Spell Trace Fever Time eventcubeSale(bool, default: false)Cube 25% off eventregion(string, default: na)Optional Nexon region for build lookup: na or euResponse:
{ recommendations: [{ description, upgradeType, expectedMesoCost, expectedDamageGainPercent, ... }], powerScore }/api/build/{IGN}/rankGet a player's leaderboard rank (overall and class-specific).
Parameters:
region(string, default: na)Optional Nexon region for build lookup: na or euResponse:
{ buildId, nexonRegion, overall, class }Calculators
/api/calc/starforceCalculate Star Force expected cost and booms.
Parameters:
itemLevel(int)Item level (required)from(int, default: 0)Current starto(int, default: 17)Target starreplacementCost(int, default: 0)Cost per boom replacement (meso)Response:
{ expectedCost, expectedBooms, statGain }/api/calc/cubeCalculate expected cubes for potential targets. Modes: tierup, wse, armor, glove, hat. Cube types: red, black, violet, equality.
Parameters:
mode(string, default: -)tierup | wse | armor | glove | hatcubeType(string, default: glowing)glowing | bright | violet | equalityattackType(string, default: att)att | matt (wse mode only)primaryStat(string, default: str)str | dex | int | luk (armor/glove/hat)currentTier(string, default: -)rare | epic | unique (tierup mode)targetTier(string, default: legendary)epic | unique | legendary (tierup mode)slot(string, default: cape)Equipment slot for violet armor ratesExample:
https://gms-upgrade-tracker.vercel.app/api/calc/cube?mode=wse&cubeType=violet&attackType=attResponse:
{ mode, cubeType, combos: [{ id, label, expectedCubes }] }/api/calc/flameCalculate expected flames to reach a target score.
Response:
{ expectedFlames, expectedCost, description }/api/calc/powerscoreCalculate converted stat from raw character stats.
Parameters:
buildId(string)Optional shared build IGN to load stats from instead of manual stat paramsregion(string, default: na)Optional Nexon region when using buildId: na or euResponse:
{ totalScore, breakdown }Leaderboard
/api/leaderboardGet the top players ranked by converted stat. Filter by server type, class, and Nexon region.
Parameters:
type(string, default: interactive)Server type: interactive or heroicregion(string, default: all)Optional region filter: all, na, or euclass(string)Filter by class (e.g. Hero, Demon Slayer)limit(int, default: 100)Number of entries (1-2000)Response:
{ entries: [{ rank, name, displayName, selectedClass, nexonRegion, sharePath, score }], serverType, region }