Docsesportsodds.gg
V1GameRankings

Team or player rankings (leaderboard)

Ranked leaderboard. `?type=team` (default) or `?type=player`. v1 ranks on a derivable metric (recent win-rate / form); the model's own provenance-independent rating is a fast-follow (`docs/planning/model-feature-spec.md`) — always our own proprietary rating, never a third party's.

GET
/v1/{game}/rankings

Ranked leaderboard. ?type=team (default) or ?type=player. v1 ranks on a derivable metric (recent win-rate / form); the model's own provenance-independent rating is a fast-follow (docs/planning/model-feature-spec.md) — always our own proprietary rating, never a third party's.

Authorization

AuthorizationBearer <token>

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*string

Game slug. cs2 is the only populated title today; an un-onboarded game 404s cleanly.

Query Parameters

type?string
Default"team"

Value in

  • "team"
  • "player"
region?string

Filter by region.

role?string

Filter by player role (type=player).

sort?string

Sort key, e.g. rating (TARGET — not yet implemented; default order is the rank metric).

limit?integer

Page size. Clamped to a per-resource maximum; cursor carries the page position.

Range1 <= value
Default100

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/cs2/rankings"
{  "data": [    {      "rank": 1,      "entity_type": "team",      "entity_id": "8161163a-f227-466f-bc01-090a01e80165",      "name": "Natus Vincere",      "region": "EU",      "role": "string",      "metric": "string",      "value": 0,      "window": "3mo",      "external_rank": 3    }  ],  "meta": {    "count": 0,    "next_cursor": "string"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}
{  "error": {    "code": "not_found",    "message": "not found",    "request_id": "018f9c7e-8b2a-7e3d-9f10-2a4b6c8d0e1f"  }}