ModelingPre-match + 34,150+ matches

CS2 prediction model API: pre-match features and full archive.

Pull current 5-man lineup ADR and rating before a match starts with /cs2/matches/{id}/lineup-stats, join 90-day map win rates and pistol/force splits, and use ETag caching to stay within quota.

  • Pre-match lineup-stats
  • ETag 304 free caching
  • Business CSV ($299/mo): Master + Delta
GET /cs2/matches/cs2-match-2400244/lineup-stats?windowDays=90200 OK
$ curl "https://api.citoapi.com/api/v1/cs2/matches/cs2-match-2400244/lineup-stats?windowDays=90" \ -H "x-api-key: $CITO_API_KEY"
{  "success": true,  "data": {    "matchId": "cs2-match-2400244",    "windowDays": 90,    "dataAvailable": true,    "team1": {      "players": [        {          "nickname": "stefienson",          "adr": 70.8,          "kdRatio": 1.04,          "rating": 1.08,          "MORE": "__more__"        }      ]    }  }}

Seamless Integration with our MCP Server

Give Claude, Cursor and ChatGPT the CS2 data. One command writes the MCP config; agents call live scoreboard, team map stat, opening duel and transfer tools instead of inventing match IDs, and your key stays on your machine.

MCPInstall the Cito MCP server
Claude
Cursor
OpenAI
Python
Cito API
Next.js
Discord
Slack
GitHub

Designed for quantitative CS2 models

Clean pre-match joins without wasting monthly request quota.

Pre-match lineup stats

GET /cs2/matches/{id}/lineup-stats returns both 5-player lineups' recent ADR, K/D, and rating before map 1.

Map pool & economy

GET /cs2/teams/{id}/map-stats?windowDays=90 gives win%, pick%, CT/T splits, pistol, eco, and force-buy win%.

Veto & H2H

vetoOrder records ban/pick/decider sequence and /cs2/h2h/{t1}/{t2} gives series and map records.

ETag 304 caching

Send If-None-Match; 304 Not Modified responses do not count against your monthly quota.

Trimmed payloads

Use ?view=summary or ?fields= to cut response size and speed up ETL pipelines.

Master + Delta CSV export

Need a multi-year CSV warehouse? Subscribe to Business CSV ($299/mo) for Master Baseline + Daily Delta downloads at 0 REST credits.

Minimize requests while scoring 30+ teams a day

Avoid polling team rosters and 90-day map stats on every upcoming match. Cache /cs2/teams/{id}/roster and /cs2/teams/{id}/map-stats?windowDays=90 locally once per day, and only fetch /cs2/matches/{id}/lineup-stats before match start.

For backtesting across 2017–2026 (34,150+ completed matches), upgrade to Business CSV ($299/mo) for Master Baseline + Daily Delta CSV downloads (0 REST credits) and unlimited >90d REST sub-caps, or use Pro/Scale (50k/100k >90d credits/mo at 5x narrow / bulk scaling).

Archive & latency

Verified production numbers.

  • The CS2 API indexes 34,261 Counter-Strike 2 matches, 5,182 teams and 10,598 players across 2,502 tournaments (as of 20 November 2026).
  • The CS2 API answered 197,791 requests in the 24 hours to 3 October 2026 with a median server response time of 227 ms.
  • The free CS2 API plan includes 500 requests a month, 10 requests a minute and live data on a 60-second delay, with no credit card.

Endpoints you can ship with

Inspect match, team and stats endpoints.

Live matches

Poll the live list for every match in progress, open one match for its round, timer, bomb and players, or keep an SSE stream open and get each update pushed.

View docs
  • GET/api/v1/cs2/live

    Matches in progress: series score, map in play, map score, current round.

  • GET/api/v1/cs2/live/{matchId}/state

    One live match: score, round, round timer, bomb status and players.

  • GET/api/v1/cs2/live/{matchId}/scoreboard

    Series score, current map and round, and each player's kills, deaths, money and equipment.

  • GET/api/v1/cs2/live/{matchId}/rounds

    Round-by-round results so far: winner, side and how each round ended.

  • GET/api/v1/cs2/live/stream

    Server-Sent Events push of every live update. Every plan; counts like polling.

  • GET/api/v1/cs2/live/ws

    WebSocket with a room per match. Scale and Enterprise; Pro with the Live WebSockets add-on.

Frequently asked questions

Features, lookback windows and CSV exports

Something missing? Email support@citoapi.com.

Does lineup-stats work for upcoming matches?

Yes. It aggregates recent form for each team's active 5-player roster over windowDays (e.g. 30 or 90).

How far back does history go on each plan?

Free covers 30 days, Starter ($15/mo) covers 90 days; Pro ($59/mo, 50k >90d credits/mo) and Scale ($100/mo, 100k >90d credits/mo) open the archive with 5x narrow / bulk scaling >=91d.

Can I download a bulk historical CS2 CSV?

Yes. Business CSV ($299/mo, +$99/mo per extra sport) includes full Master Baseline + Daily Delta CSV downloads at 0 REST credits plus unlimited >90d REST sub-caps.

See pricing

Train on lineup stats

Start free, or use Business CSV ($299/mo) for Master + Daily Delta downloads.