GunSpec

Game Stats Snapshots

Versioned snapshots of game-balance stats. Pin your game to a specific dataset version (e.g., "2026.1") so stat rebalancing doesn't break your build mid-development. When you're ready to pick up new values, switch to a newer version on your own schedule.

Auth RequiredBuilder+

Get Game Stats (Live)

Returns live game-balance stats (0-100 scale) for a single firearm. These track the current dataset and change when the catalog is rebalanced. Pin a snapshot version instead if you need stability across a development cycle.

GET/v1/firearms/{id}/game-stats

Builder+

  • stringheaderrequired

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

  • stringrequired

    Resource slug ID

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

application/json

  • FirearmGameStats

    The response payload

  • string

    URL-safe slug identifying the firearm, e.g. glock-17-gen5.

  • string

    Display name, as the maker writes it.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure. These are balance numbers for game use and are not derived from the ballistics above.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure.

  • integer | null

    Editorial game statistic, 0-100. Not a measured figure.

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

Requires Builder tier or higher.

All 8 stats are normalized 0-100, derived from real-world specs using weighted formulas.

This returns live data. For frozen/stable stats, use the versioned snapshots at /v1/game-stats/versions.

Perfect for FPS games, RPGs, tactical sims, and card games.

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.