GunSpec

Game Balance

Game development tools for validating game stats against real-world specifications. Identify firearms where your game balance deviates significantly from expected values.

Auth RequiredBuilder+

Tier List

Ranks firearms into S/A/B/C/D tiers for a single game stat.

GET/v1/game/tier-list

Builder+

  • stringheaderrequired

    Your API key. Authorization: Bearer <key> is accepted in its place.

  • stringdefaultdamage

    Which stat to tier by

    Accepts
    Example
  • string

    Restrict the tier list to a category slug

    Example

application/json

  • object

    The response payload.

  • string

    Which statistic this row is about, named as the field is: weightEmptyG, damage.

  • object

    Firearms grouped into tiers, strongest first.

  • object[]

    Top tier for this stat.

  • object[]

    Second tier.

  • object[]

    Third tier.

  • object[]

    Fourth tier.

  • object[]

    Bottom tier for this stat.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Requires Builder tier or higher.

Valid stats: damage, accuracy, range, fireRate, mobility, recoilControl, reloadSpeed, concealment.

Omit the stat parameter to rank by a composite score across all 8 stats.

Tiers use percentile bucketing: S (90th+), A (75-90th), B (50-75th), C (25-50th), D (<25th).

Full rate limits

Minimum tier
Builder+
Monthly quota
25,000/mo
Rate limit
60/min
Daily cap
2,000

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.