Per-player CS2 depth breakdowns for one match
The five CS2 depth breakdowns for one match, grouped into a single object: per-player `weapons`, `grenades`, `hitgroups` (body hit-group distribution), `duels` (the killer→victim kills matrix) and `flashes` (the flasher→flashed blind matrix). These are per-MATCH aggregates (not per map). Each group is a flat array whose elements carry their own `player_id` (and, for duels/flashes, the ordered pair of player ids), so a client groups by player itself. A match with no depth on record (older or lower-tier matches — roughly one in six lack it) returns every group as an empty array (never null); an unknown match id does the same. Single-resource envelope: `{"data": {weapons, grenades, hitgroups, duels, flashes}}`.
The five CS2 depth breakdowns for one match, grouped into a single object: per-player weapons, grenades, hitgroups (body hit-group distribution), duels (the killer→victim kills matrix) and flashes (the flasher→flashed blind matrix). These are per-MATCH aggregates (not per map). Each group is a flat array whose elements carry their own player_id (and, for duels/flashes, the ordered pair of player ids), so a client groups by player itself. A match with no depth on record (older or lower-tier matches — roughly one in six lack it) returns every group as an empty array (never null); an unknown match id does the same. Single-resource envelope: {"data": {weapons, grenades, hitgroups, duels, flashes}}.
Primary auth (live). Authorization: Bearer <api-key> — the header takes precedence over the query fallback. The raw key is hashed (SHA-256, hex) and looked up in api.keys.key_hash; the raw value is never stored.
In: header
Path Parameters
Game slug. cs2 is the only populated title today; an un-onboarded game 404s cleanly.
Resource identifier — either a UUID or the resource's human-readable slug, scoped to {game}. /v1/cs2/teams/natus-vincere and /v1/cs2/teams/019f23d1-fb5c-7987-b522-47c3a5e72111 address the same row, so you can go straight from a slug you already have without first looking up its id.
Slugs work on teams, players and tournaments. Matches have no slug, so a match id must be a UUID. Either way, an identifier that resolves to nothing returns 404 not_found.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/cs2/matches/019f2858-e253-7f3d-bdff-bc7738bd1036/depth"{ "data": { "weapons": [ { "id": "01a0b3da-19a2-7701-ba5c-62163a0fdae4", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "weapon_slug": "galil-ar", "weapon_name": "Galil AR", "weapon_class": "Rifle", "team_side": "t", "shots": 51, "hits": 13, "kills": 5, "headshots": 2, "damage": 419, "wall_bangs": 0, "trade_kills": 3, "created_at": "2026-09-18T09:30:10.210859Z" }, { "id": "01a0b3da-19a2-7e78-b06f-b38c92fc4a8d", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "weapon_slug": "ak-47", "weapon_name": "AK-47", "weapon_class": "Rifle", "team_side": "t", "shots": 90, "hits": 10, "kills": 4, "headshots": 3, "damage": 427, "wall_bangs": 0, "trade_kills": 1, "created_at": "2026-09-18T09:30:10.210859Z" } ], "grenades": [ { "id": "01a0b3da-19a2-7eaa-9c6f-db8006638024", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "grenade_name": "Decoy Grenade", "team_side": "t", "owns": 0, "throws": 1, "hits": 0, "kills": 0, "created_at": "2026-09-18T09:30:10.210859Z" }, { "id": "01a0b3da-19a2-78c1-99ca-aacbf1027ac3", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "grenade_name": "Flashbang", "team_side": "ct", "owns": 1, "throws": 3, "hits": 3, "kills": 0, "created_at": "2026-09-18T09:30:10.210859Z" } ], "hitgroups": [ { "id": "01a0b3da-19a2-7f49-a174-69135ecd3261", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "hit_group": "Chest", "team_side": "ct", "hits": 10, "damage": 186, "kills": 1, "created_at": "2026-09-18T09:30:10.210859Z" }, { "id": "01a0b3da-19a2-7c60-a457-5a79b1dfaaf6", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "hit_group": "Chest", "team_side": "t", "hits": 14, "damage": 275, "kills": 2, "created_at": "2026-09-18T09:30:10.210859Z" } ], "duels": [ { "id": "01a0b3da-19a2-77c0-8c15-ee184bda4dac", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "killer_player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "victim_player_id": "019f28e2-76af-7029-97b5-70686851cd14", "kind": "enemy", "kills": 5, "weapon_names": "M4A1, M4A1, M4A1, M4A4, MP9", "created_at": "2026-09-18T09:30:10.210859Z" }, { "id": "01a0b55a-a37c-7cfa-a564-502ce254b543", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "killer_player_id": "01a0a3e2-96a0-7b37-8172-f2fae5cb4679", "victim_player_id": "019f2bda-1afe-7645-b9dd-b05c9a89b19e", "kind": "team", "kills": 1, "weapon_names": "AK-47", "created_at": "2026-09-18T16:30:11.325144Z" } ], "flashes": [ { "id": "01a0b3da-19a2-7e28-8a64-b5117cd27449", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "flasher_player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "flashed_player_id": "019f28e2-22cb-7de3-b94b-7652094f468c", "count": 5, "duration_ns": 7217897904, "created_at": "2026-09-18T09:30:10.210859Z" }, { "id": "01a0b3da-19a2-7aa2-baa5-474feee9aa5b", "match_id": "01a0a3e2-96a5-7a9f-8af2-fae0f1a7d678", "flasher_player_id": "019f28e1-e6af-7c9e-9dbf-9f83509caa47", "flashed_player_id": "019f28e2-22cb-74ea-af0f-0408f360cec2", "count": 2, "duration_ns": 4303754880, "created_at": "2026-09-18T09:30:10.210859Z" } ] }}{ "error": { "code": "not_found", "message": "not found", "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578" }}{ "error": { "code": "not_found", "message": "not found", "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578" }}{ "error": { "code": "rate_limited", "message": "rate limit exceeded", "request_id": "019f3d18-c15f-7319-81a7-343e8a80a578" }}Mint a short-lived WebSocket ticket POST
Exchanges the caller's API key for a short-lived (60s) signed ticket used to open the WebSocket at `wss://api.esportsodds.gg/v1/ws?token=...`. Keeps the raw key off the wire and out of the browser — browsers can't set headers on a `WebSocket`, which is why tickets exist. Minting is authenticated, rate-limited and metered like any REST call. This is the only part of the WebSocket surface expressible in OpenAPI: the socket itself (`/v1/ws`) is a persistent connection with its own message protocol, so it is documented as prose instead — see **[Live data & WebSocket](/docs/live-data)** for the handshake, the message envelope, subscribing, sequence numbers, reconnection and the connection cap. Read that page before building against this endpoint; a ticket on its own does nothing.
A single match GET
One match by id, with the same fields as a list row minus the denormalised names — a detail row carries bare `team_a_id`/`team_b_id`/`tournament_id`, so resolve those separately or read them off the list route instead. The `data_available` flags tell you which sub-resources (`maps`, `stats`, `map_stats`, `vetoes`, `rounds`, `depth`, `lineups`, `odds`) actually exist for this match, so you can skip requests that would return an empty list. Pass `include=` to embed related resources or the sub-resources themselves in this one response.