GameStats

Resource class for interacting with the GunSpec Game Stats Snapshots API. Wraps all /v1/game-stats endpoints. Instantiated internally by the GunSpec client and exposed as client.gameStats.

Auth RequiredBuilder+

client.gameStats.listVersions()

List all available game stats snapshot versions.

listVersions(): Promise<APIResponse<GameStatsVersion[]>>

GET/v1/game-stats/versions

Builder+

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

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

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.

1import { GunSpec } from '@buun_group/gunspec-sdk';2 3const client = new GunSpec();4 5const { data } = await client.gameStats.listVersions();6for (const version of data) {7  console.log(version.version, version.createdAt, version.description);8}

1{2  "success": true,3  "data": [4    {5      "id": 1,6      "version": "2025.1",7      "description": "Initial game stats snapshot",8      "firearmCount": 450,9      "createdAt": "2025-06-01 12:00:00"10    }11  ]12}

Auth RequiredBuilder+

client.gameStats.listFirearms()

List all firearms in a specific game stats snapshot version.

listFirearms(version: string, params?: ListSnapshotFirearmsParams): Promise<PaginatedResponse<GameStatsSnapshotEntry>>

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

Builder+

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

stringrequired
Snapshot version
Accepts
matching ^[a-z0-9][a-z0-9.\-]*$
Example

integerdefault1
Page number, from 1 to 10,000
Range
1 – 10000
Example
integerdefault20
Items per page (max 100)
Range
1 – 100
Example

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

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.

1import { GunSpec } from '@buun_group/gunspec-sdk';2 3const client = new GunSpec();4 5const result = await client.gameStats.listFirearms('2025.1', { per_page: 50 });6for (const firearm of result.data) {7  console.log(firearm.name, firearm.damage);8}

1{2  "success": true,3  "data": [4    {5      "firearm_id": "glock-17-gen5",6      "firearm_name": "Glock 17 Gen5",7      "game_damage": 42,8      "game_accuracy": 68,9      "game_range": 35,10      "game_fire_rate": 55,11      "game_mobility": 78,12      "game_recoil_control": 62,13      "game_reload_speed": 72,14      "game_concealment": 7015    }16  ],17  "pagination": {18    "page": 1,19    "limit": 20,20    "per_page": 20,21    "total": 42,22    "totalPages": 323  }24}

Auth RequiredBuilder+

client.gameStats.getFirearm()

Get a single firearm's game stats from a specific snapshot version.

getFirearm(version: string, id: string): Promise<APIResponse<GameStatsSnapshotEntry>>

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

Builder+

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

stringrequired
Snapshot version
Accepts
matching ^[a-z0-9][a-z0-9.\-]*$
Example
stringrequired
Firearm slug
Accepts
a lowercase slug: letters, digits and hyphens
Example

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

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.

1import { GunSpec } from '@buun_group/gunspec-sdk';2 3const client = new GunSpec();4 5const { data } = await client.gameStats.getFirearm('2025.1', 'glock-g17');6console.log(data.damage, data.accuracy, data.range);

1{2  "success": true,3  "data": {4    "firearm_id": "glock-17-gen5",5    "firearm_name": "Glock 17 Gen5",6    "game_damage": 42,7    "game_accuracy": 68,8    "game_range": 35,9    "game_fire_rate": 55,10    "game_mobility": 78,11    "game_recoil_control": 62,12    "game_reload_speed": 72,13    "game_concealment": 7014  }15}

GameStats

AuthorizationBuilder+

Response200application/json

Errors

Rate limitsFull rate limits

AuthorizationBuilder+

Path Parameters

Query Parameters

Response200application/json

Errors

Rate limitsFull rate limits

AuthorizationBuilder+

Path Parameters

Response200application/json

Errors

Rate limitsFull rate limits

Builder+

application/json

Full rate limits

Builder+

application/json

Full rate limits

Builder+

application/json

Full rate limits