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
{ "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 serverDesigned 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.
- GET
/api/v1/cs2/liveMatches in progress: series score, map in play, map score, current round.
- GET
/api/v1/cs2/live/{matchId}/stateOne live match: score, round, round timer, bomb status and players.
- GET
/api/v1/cs2/live/{matchId}/scoreboardSeries score, current map and round, and each player's kills, deaths, money and equipment.
- GET
/api/v1/cs2/live/{matchId}/roundsRound-by-round results so far: winner, side and how each round ended.
- GET
/api/v1/cs2/live/streamServer-Sent Events push of every live update. Every plan; counts like polling.
- GET
/api/v1/cs2/live/wsWebSocket with a room per match. Scale and Enterprise; Pro with the Live WebSockets add-on.
Results
Finished matches with the series score and winner, every map and its score, and the player lines behind them.
- GET
/api/v1/cs2/matches/recentFinished matches with final series score and winner, newest first.
- GET
/api/v1/cs2/matches/{matchId}One match: event, teams, series score, and maps.
- GET
/api/v1/cs2/matches/{matchId}/mapsEach map: name, score, winner, and the team that picked it.
- GET
/api/v1/cs2/matches/{matchId}/player-statsPer-player stats for each map: kills, deaths, ADR, KAST and rating.
- GET
/api/v1/cs2/teams/{teamIdOrSlug}/resultsOne team's finished matches, newest first.
- GET
/api/v1/cs2/events/{eventIdOrSlug}/resultsFinal placements and prize money of a tournament.
Schedule
What is on next: upcoming matches soonest first, today's slate, one team's fixtures, and the tournament calendar.
- GET
/api/v1/cs2/matches/upcomingScheduled matches, soonest first.
- GET
/api/v1/cs2/matches/todayMatches scheduled, live or finished today (UTC).
- GET
/api/v1/cs2/teams/{teamIdOrSlug}/upcomingOne team's scheduled matches.
- GET
/api/v1/cs2/events/upcomingScheduled tournaments, soonest first.
- GET
/api/v1/cs2/events/calendarTournaments in a date range, with from and to.
- GET
/api/v1/cs2/matches/{matchId}/streamsBroadcast links for a match, when known.
Odds & models
Match and map winner prices with implied probability, liquidity and spread, every price change since the market opened, and the team form, map stats and head-to-head a model needs next to them.
- GET
/api/v1/cs2/matches/upcoming?include=oddsUpcoming matches with each one's current market prices attached.
- GET
/api/v1/cs2/matches/{matchId}/oddsMatch and map winner odds: decimal price, implied probability, liquidity, spread, status.
- GET
/api/v1/cs2/matches/{matchId}/odds/historyEvery captured price change for the match and each map, oldest first.
- GET
/api/v1/cs2/teams/{teamIdOrSlug}/formA team's recent results and win rate.
- GET
/api/v1/cs2/teams/{teamIdOrSlug}/map-statsWin rate and matches played on each map.
- GET
/api/v1/cs2/h2h/{teamIdOrSlug}/{opponentIdOrSlug}Head-to-head record and the meetings behind it.
Positions & heatmaps
Where every grenade went off, where each kill and death happened, and where the bomb was planted, in game coordinates and already placed on the map's radar, plus heatmaps per map or per player.
- GET
/api/v1/cs2/maps/{mapId}/utilityEvery smoke, flash, HE and molotov on a map: landing spot, thrower, round, duration.
- GET
/api/v1/cs2/maps/{mapId}/positionsGrenades, bomb plants and kills with attacker and victim spots and callouts, in order.
- GET
/api/v1/cs2/maps/{mapId}/heatmap?kind=smokeCounts per radar cell for smokes, flashes, molotovs, plants, kills or deaths.
- GET
/api/v1/cs2/players/{playerIdOrSlug}/utility?map=MirageWhere one player's grenades land across recent maps, with a heatmap.
- GET
/api/v1/cs2/map-radarsRadar calibration per map to draw any point on a radar image.
Player stats
K/D and rating per map played (ADR and KAST on over 95% of map lines), rolled up into career, yearly and recent-form views.
- GET
/api/v1/cs2/players/{playerIdOrSlug}Nickname, real name, photo, country, team, role and headline stats.
- GET
/api/v1/cs2/players/{playerIdOrSlug}/statsCareer totals plus a stat line per map played.
- GET
/api/v1/cs2/players/{playerIdOrSlug}/seasonsA player's stats by year.
- GET
/api/v1/cs2/players/{playerIdOrSlug}/formThe most recent maps with kills, deaths, ADR, KAST and rating.
- GET
/api/v1/cs2/leaderboards/{metric}Top players by rating, ADR, KAST, K/D, kills or opening kills.
- GET
/api/v1/cs2/players/search?q={name}Find a player by nickname or real name.
Teams & rosters
Team profiles with the current roster, every past lineup, player moves between teams, and how each team plays each map.
- GET
/api/v1/cs2/teams/{teamIdOrSlug}Name, logo, country, region, world ranking and current roster.
- GET
/api/v1/cs2/teams/{teamIdOrSlug}/roster-historyEvery player who has played for the team, with start and end dates.
- GET
/api/v1/cs2/teams/{teamIdOrSlug}/map-statsPer-map win rate, rounds and pick/ban tendencies.
- GET
/api/v1/cs2/teams/{teamIdOrSlug}/vs/{opponentIdOrSlug}Record and past matches between two teams.
- GET
/api/v1/cs2/roster-changes/recentPlayers joining and leaving teams, newest first.
- GET
/api/v1/cs2/transfers/recentPlayer moves between teams, newest first.
Rankings
The world team ranking and the Valve Regional Standings, with points and movement, plus one table per region.
- GET
/api/v1/cs2/rankings/worldThe latest world team ranking.
- GET
/api/v1/cs2/rankings/vrsThe latest Valve Regional Standings (VRS).
- GET
/api/v1/cs2/rankings/region/{region}One region, with each team's world and regional rank.
- GET
/api/v1/cs2/rankingsOne row per team, with points and change since the previous ranking.
Skin prices
The current price of a skin on each marketplace, its daily price history, sell listings across markets, and the week's biggest movers.
- GET
/api/v1/cs2/skins?q={name}Search skins by name, weapon, rarity or price range.
- GET
/api/v1/cs2/skins/{skinIdOrSlug}/pricesThe current price on each marketplace, cheapest first, with offer counts.
- GET
/api/v1/cs2/skins/{skinIdOrSlug}/historyDaily cheapest price across marketplaces, years back on long-listed skins.
- GET
/api/v1/cs2/skins/{skinIdOrSlug}/order-bookSell listings per marketplace with counts, and the lowest ask.
- GET
/api/v1/cs2/skins/trendingBiggest gainers and losers over 1 day to 1 year, with sparklines.
- GET
/api/v1/cs2/skins/{skinIdOrSlug}One skin: weapon, rarity, collection, image and price summary.
Tournaments
Tournaments with dates, prize pool, tier and format, plus every match, the standings and the bracket.
- GET
/api/v1/cs2/events/liveTournaments being played now.
- GET
/api/v1/cs2/events/{eventIdOrSlug}Dates, location, prize pool, tier, teams and format.
- GET
/api/v1/cs2/events/{eventIdOrSlug}/matchesEvery match of the tournament.
- GET
/api/v1/cs2/events/{eventIdOrSlug}/standingsTeams with seed, final placement and prize.
- GET
/api/v1/cs2/events/{eventIdOrSlug}/bracketBracket, groups, play-in and Swiss, each slot with teams, scores and winner.
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.
Modeler building blocks
- CS2 historical data API34,150+ completed matches since 2017 for models and backtests.
- CS2 map stats APIMap win rates, side splits, economy and veto history.
- CS2 player props APIPick'em player prop lines, status=all closed lines, and line movement history.
- VRS rankings APIDated Valve Regional Standings snapshots back to 2024-08-06 and world rankings.
- CS2 odds APIPrediction-market match and map prices with market status and odds history.
Train on lineup stats
Start free, or use Business CSV ($299/mo) for Master + Daily Delta downloads.