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.

Authentifizierung erforderlichBuilder+

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+

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

  • stringerforderlich

    Resource slug ID

    Akzeptiert
    a lowercase slug: letters, digits and hyphens
    Beispiel

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.

Alle Anfragelimits

Mindeststufe
Builder+
Monatskontingent
25,000/mo
Anfragerate
60/min
Tageslimit
2,000

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.

Authentifizierung erforderlichBuilder+

List Snapshot Versions

Returns every available game stats snapshot version, newest first. Pin your build to a version so a rebalance of the live catalog cannot change your numbers mid-development.

GET/v1/game-stats/versions

Builder+

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

application/json

  • GameStatsVersion[]

    The response payload.

  • integer

    Autoincrementing version id.

  • string

    Version label, e.g. 2025.1.

  • string | null

    Prose summary of the record, where one has been written.

  • integer

    How many firearms carried game statistics in this version.

  • string

    When the record was first added, YYYY-MM-DD HH:MM:SS in UTC.

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

Requires Builder tier or higher.

Versions are sorted newest first.

Workflow: 1) List versions, 2) Pick one to pin your game to, 3) Fetch stats via /v1/game-stats/versions/{version}/firearms, 4) When ready, switch to a newer version.

Alle Anfragelimits

Mindeststufe
Builder+
Monatskontingent
25,000/mo
Anfragerate
60/min
Tageslimit
2,000

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.

Authentifizierung erforderlichBuilder+

List Firearms in Version

Returns paginated game stats for every firearm frozen into one snapshot version.

GET/v1/game-stats/versions/{version}/firearms

Builder+

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

  • stringerforderlich

    Snapshot version

    Akzeptiert
    matching ^[a-z0-9][a-z0-9.\-]*$
    Beispiel

  • integerstandard1

    Page number, from 1 to 10,000

    Bereich
    1 – 10000
    Beispiel
  • integerstandard20

    Items per page (max 100)

    Bereich
    1 – 100
    Beispiel

application/json

  • GameStatsSnapshotEntry[]

    One page of results

  • string

    Slug of the firearm this row is about.

  • string

    Display name at the time the snapshot was taken.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • number

    Current page number

  • number

    Items per page

  • number

    Total matching records (Builder and above)

  • 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.

Stats are frozen: they never change for a given version.

Results are sorted alphabetically by firearm name.

Use per_page=100 to fetch in larger batches for bulk loading.

Alle Anfragelimits

Mindeststufe
Builder+
Monatskontingent
25,000/mo
Anfragerate
60/min
Tageslimit
2,000

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.

Authentifizierung erforderlichBuilder+

Get Firearm in Version

Returns the game stats for a single firearm as frozen in one snapshot version.

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

Builder+

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

  • stringerforderlich

    Snapshot version

    Akzeptiert
    matching ^[a-z0-9][a-z0-9.\-]*$
    Beispiel
  • stringerforderlich

    Firearm slug

    Akzeptiert
    a lowercase slug: letters, digits and hyphens
    Beispiel

application/json

  • GameStatsSnapshotEntry

    The response payload

  • string

    Slug of the firearm this row is about.

  • string

    Display name at the time the snapshot was taken.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • integer | null

    Editorial game statistic as it stood in this snapshot, 0-100.

  • 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.

Returns 404 if the firearm had no game stats when the snapshot was created.

Stats are frozen: identical every time you call this for the same version.

Alle Anfragelimits

Mindeststufe
Builder+
Monatskontingent
25,000/mo
Anfragerate
60/min
Tageslimit
2,000

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.