Team Extras

GET

cs2

teams

{hltv_id}

extras

Heavy on-the-fly aggregations for a CS2 team

curl --request GET \
  --url https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "hltv_id": 11712,
    "name": "Sashi",
    "country_code": "DK",
    "world_ranking": 42,
    "region": "EMEA",
    "time_filter": "3months",
    "map_stats": [
      {
        "map_name": "all",
        "maps_played": 87,
        "wins": 51,
        "losses": 33,
        "win_rate": 0.586,
        "rating": 1.06,
        "ct_round_win_pct": 0.524,
        "t_round_win_pct": 0.481
      }
    ]
  }
}

{
  "detail": "Missing X-API-Key or $x$access-token header"
}

{
  "detail": "Required scope 'cs2:matches:detail' is not granted to this API key. Contact your account manager to extend the key's scopes."
}

{
  "detail": "Match not found"
}

{
  "detail": [
    {
      "type": "enum",
      "loc": [
        "query",
        "time_filter"
      ],
      "msg": "Input should be one of: 3m, 6m, 1y, all",
      "input": "2w"
    }
  ]
}

{
  "detail": "Rate limit exceeded (600 req/min)"
}

What it returns

Seven heuristic aggregations that walk recent Match / Map / Round rows on each call. Pulled into a separate endpoint so the cheap Get Team call doesn’t pay this cost — only the model team uses these.

`race_to_rates`

Win % when this team races to 6, 9, or 12 round wins on a map. Sample taken from the last 30 finished maps.

{
  "race_to_6_win_pct": 0.612,
  "race_to_9_win_pct": 0.547,
  "race_to_12_win_pct": 0.481,
  "sample_maps": 27
}

`headshot_pct`

Weighted-average HS% across the team’s roster (rounds-played as weight). Pulls from PlayerMapStats.map_name = "all" for the requested window.

`economy_profile`

Round-level economy splits from ScoreBot data, last 40 finished matches.

Field	Meaning
`eco_win_pct`	Eco-round win %
`force_buy_win_pct`	Force-buy win %
`full_buy_win_pct`	Full-buy win %
`full_buy_vs_opponent_full_buy_win_pct`	Mirror full-buy duels
`post_plant_win_pct_as_t`	T-side win % after planting
`r2_conversion_after_pistol_win`	Round 2 win % after winning the pistol round
`sample_rounds`	Volume

`overtime_stats`

OT map win rate from Map.overtime_periods > 0.

{ "ot_maps_played": 12, "ot_maps_won": 7, "ot_win_pct": 0.583 }

`lan_online_split`

Match win rate split by venue (match_scope = lan or online).

{
  "lan_maps_played": 38, "lan_wins": 22, "lan_win_pct": 0.579,
  "online_maps_played": 84, "online_wins": 51, "online_win_pct": 0.607
}

`map_streaks`

Current W/L streak per map, sorted by streak length. Each entry: { map_name, streak_type: "W" | "L", streak_length }. Useful for “team is on a 5-map win streak on Mirage” widgets.

`map_pool`

Derived from veto picks across the team’s recent matches. Each entry: { map_name, picks }, sorted by pick count. Distinct from the global Active Map Pool — this is what this team actually picks.

Required scope

Minimum: cs2:teams:read

Query

Param	Default	Description
`time_filter`	`3m`	Window for `headshot_pct` only. Accepts `3m`, `6m`, `1y`, `all`. Other blocks use rolling windows on raw Match/Map/Round data.

Example

curl -H "X-API-Key: $TT_KEY" \
  "https://ticktock.bet/cs2/v1/teams/11712/extras?time_filter=6m"

Use cases

Pre-match modelling — feed economy_profile + race_to_rates + headshot_pct straight into your features.
Match-preview “form” widgets — map_streaks + lan_online_split.
Map-specific micro-markets — pricing decisions informed by map_pool and map_streaks.

Authorizations

X-API-Key

string

header

required

Tenant API key issued during onboarding

Path Parameters

hltv_id

integer

required

Query Parameters

time_filter

string

default:3m

Window for headshot_pct: 3m, 6m, 1y, all.

Response

Successful Response

The response is of type Response Get Team Extras Cs2 V1 Teams Hltv Id Extras Get · object.

Last modified on May 10, 2026

Team Head-to-HeadAggregate W/L plus deep round-level analytics across every finished match between two teams

Heavy on-the-fly aggregations for a CS2 team

curl --request GET \
  --url https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ticktock.bet/cs2/v1/teams/{hltv_id}/extras")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "hltv_id": 11712,
    "name": "Sashi",
    "country_code": "DK",
    "world_ranking": 42,
    "region": "EMEA",
    "time_filter": "3months",
    "map_stats": [
      {
        "map_name": "all",
        "maps_played": 87,
        "wins": 51,
        "losses": 33,
        "win_rate": 0.586,
        "rating": 1.06,
        "ct_round_win_pct": 0.524,
        "t_round_win_pct": 0.481
      }
    ]
  }
}

{
  "detail": "Missing X-API-Key or $x$access-token header"
}

{
  "detail": "Required scope 'cs2:matches:detail' is not granted to this API key. Contact your account manager to extend the key's scopes."
}

{
  "detail": "Match not found"
}

{
  "detail": [
    {
      "type": "enum",
      "loc": [
        "query",
        "time_filter"
      ],
      "msg": "Input should be one of: 3m, 6m, 1y, all",
      "input": "2w"
    }
  ]
}

{
  "detail": "Rate limit exceeded (600 req/min)"
}

Overview

Search

Matches

Markets

Settlements

Tournaments

Teams

Players

Maps

Stream (WebSocket)

What it returns

`race_to_rates`

`headshot_pct`

`economy_profile`

`overtime_stats`

`lan_online_split`

`map_streaks`

`map_pool`

Required scope

Query

Example

Use cases

Authorizations

Path Parameters

Query Parameters

Response

​What it returns

​race_to_rates

​headshot_pct

​economy_profile

​overtime_stats

​lan_online_split

​map_streaks

​map_pool

​Required scope

​Query

​Example

​Use cases

Authorizations

Path Parameters

Query Parameters

Response

What it returns

`race_to_rates`

`headshot_pct`

`economy_profile`

`overtime_stats`

`lan_online_split`

`map_streaks`

`map_pool`

Required scope

Query

Example

Use cases