CS2 Odds API
Prediction-market prices for Counter-Strike 2 matches as decimal odds: the series winner and every map, updated as soon as the market price changes (live matches and matches starting within 6 hours; further out every 15 minutes), all through each map and between rounds. The CS2 live WebSocket pushes every change as a cs2.odds.updated message with the map, round and round phase it happened in. History rows carry the map and round (filter with map, round and phase), and /cs2/matches/{matchId}/odds/rounds gives every market's price at the start and end of each round. Each quote says whether its market is open, suspended (a decided map) or closed. A market is attached to a match only when both teams match and it starts within 6 hours of the market's start time, and every link is re-checked against the current match every 15 minutes, so a rescheduled or re-paired match never keeps another match's odds. Odds are included on Pro and above.
3 endpoints in this section. Authenticate with the x-api-key header; every response is { success, data, meta }. Other sections: Live, Player props, Positions & heatmaps, Watch live (embeds), Pro skins & 3D, Matches, Maps & rounds, Rankings, Teams, Players, Events, Stats & leaderboards, Skins, Transfers, Search & reference.
Match odds
Current prediction-market prices for a match as decimal odds per team: the series winner (`market: "h2h"`) and each map (`"map_h2h_1"`, `"map_h2h_2"`, ...). `team1Odds` / `team2Odds` follow the match's `team1` / `team2`. `provider` is the market the price comes from (`prediction_market`). **Freshness.** Prices update as soon as the market price changes (live and upcoming matches starting within 6 hours, through every map and between rounds): Measured on live CS2 matches (November 2026): a price change reaches WebSocket clients in about 0.3 s (95% within 0.4 s, 99% within 0.6 s) after the market moved; REST returns it from the next call. A rare database stall can hold a change back for up to about 40 s. Every open market is also re-checked each minute, so `capturedAt` (the time the price was last confirmed) is never more than about a minute old on a live match. Matches further out refresh every 15 minutes. To have changes pushed instead of polling, use the CS2 live WebSocket (`cs2.odds.updated`, see `/cs2/live/stream`). **Market status.** `marketStatus` is `open` while the market is trading; `suspended` once its price is near-certain (a decided map), showing the last tradable quote; `closed` when the market is no longer listed. **Pricing.** Decimal odds are 1 / implied probability (2.00 = 50%), with no bookmaker margin added. Only matches the market lists have odds; others return `dataAvailable: false`. **Match id.** Use the `matchId` from `/cs2/live` or `/cs2/matches/upcoming`, or the two team names as `team1-vs-team2` (`/cs2/matches/vitality-vs-mouz/odds`, either order): the live match wins, else the one nearest in time. **Plans.** Odds are included on Pro and above.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
| limit | integer | Rows to return. Maximum 200; larger values are reduced to 200. |
Example
curl "https://api.citoapi.com/api/v1/cs2/matches/MATCH_ID/odds" \
-H "x-api-key: YOUR_API_KEY"Response
{
"success": true,
"data": {
"entityType": "cs2_match_odds",
"matchId": "cs2-match-2399722",
"teams": {
"team1Name": "MOUZ",
"team2Name": "Liquid"
},
"eventName": "PGL Masters Bucharest 2026",
"dataAvailable": true,
"odds": [
{
"oddsKey": "market:5774511",
"matchId": "cs2-match-2399722",
"provider": "prediction_market",
"market": "h2h",
"team1Odds": 3.27,
"team2Odds": 1.44,
"drawOdds": null,
"team1ImpliedProb": 0.3058,
"team2ImpliedProb": 0.6944,
"liquidityUsd": null,
"volumeUsd": null,
"volume24hUsd": null,
"bestBid": null,
"bestAsk": null,
"spread": null,
"marketStatus": "closed",
"capturedAt": "2026-10-24T12:33:05.329Z"
},
{
"oddsKey": "market:5774510",
"matchId": "cs2-match-2399722",
"provider": "prediction_market",
"market": "map_h2h_2",
"team1Odds": 6.06,
"team2Odds": 1.2,
"drawOdds": null,
"team1ImpliedProb": 0.165,
"team2ImpliedProb": 0.8333,
"liquidityUsd": null,
"volumeUsd": null,
"volume24hUsd": null,
"bestBid": null,
"bestAsk": null,
"spread": null,
"marketStatus": "closed",
"capturedAt": "2026-10-24T11:31:05.402Z"
}
]
},
"meta": {
"count": 2,
"dataAvailable": true,
"limit": 2,
"total": 2,
"page": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}Match odds history
Line movement for a match: one row each time a market's price changed, oldest first (opening, pre-match and live prices through to the last tradable quote). Filter one market with `market` (`h2h`, `map_h2h_1`, ...). **Where the match stood.** Rows recorded from 2026-11-04 carry `mapNumber`, `round` (the round being played, or the next round while `roundPhase` is `between_rounds`), `roundPhase` (`in_round`, `between_rounds`, `map_over`; `not_live` when the match was not being played), `team1RoundScore`, `team2RoundScore`, `ctTeam` and `sourceTimestamp` (when the market price changed). Earlier rows have null there. **Filters.** `map` and `round` (numbers), `phase` (`in_round`, `between_rounds`, `map_over`), `since` (ISO time), `order=desc` for newest first, `limit` (default 500, max 2000). `map`, `round` and `phase` only match rows that carry a round. Bad values return 400 `INVALID_PARAMETER`. Same price fields as `/cs2/matches/{matchId}/odds`. Odds are included on Pro and above.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
| limit | integer | Rows (default 500, max 2000). Maximum 2000; larger values are reduced to 2000. |
| map | string | Map number (1, 2, ...): only rows recorded while this map was being played. |
| market | string | One market: h2h (series winner) or map_h2h_1, map_h2h_2, ... |
| order | string | asc (default, oldest first) or desc. |
| phase | string | in_round, between_rounds or map_over. |
| round | string | Round number: only rows recorded while this round was being played (or, between rounds, before it started). |
| since | string | ISO time: only changes at or after it. |
Example
curl "https://api.citoapi.com/api/v1/cs2/matches/MATCH_ID/odds/history" \
-H "x-api-key: YOUR_API_KEY"Response
{
"success": true,
"data": {
"entityType": "cs2_match_odds_history",
"matchId": "cs2-match-2399722",
"teams": {
"team1Name": "MOUZ",
"team2Name": "Liquid"
},
"eventName": "PGL Masters Bucharest 2026",
"dataAvailable": true,
"history": [
{
"oddsKey": "market:5774511",
"matchId": "cs2-match-2399722",
"provider": "prediction_market",
"market": "h2h",
"team1Odds": 1.25,
"team2Odds": 5,
"capturedAt": "2026-10-16T17:54:35.562Z",
"mapNumber": null,
"round": null,
"roundPhase": null,
"team1RoundScore": null,
"team2RoundScore": null,
"ctTeam": null,
"priceTimestamp": null
},
{
"oddsKey": "market:5774509",
"matchId": "cs2-match-2399722",
"provider": "prediction_market",
"market": "map_h2h_1",
"team1Odds": 2.04,
"team2Odds": 1.96,
"capturedAt": "2026-10-16T17:54:35.562Z",
"mapNumber": null,
"round": null,
"roundPhase": null,
"team1RoundScore": null,
"team2RoundScore": null,
"ctTeam": null,
"priceTimestamp": null
}
]
},
"meta": {
"count": 2,
"dataAvailable": true,
"limit": 2,
"total": 2,
"page": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}Match odds by round
The price of every market of the match at the start and at the end of each round, recorded live: `rounds[]` with `mapNumber`, `mapName`, `round`, `start` (when the round went live after freeze time: `observedAt`, `odds[]`) and `end` (when the round was won: `observedAt`, `team1RoundScore`, `team2RoundScore`, `roundWinner` `team1`/`team2`, `ctTeam`, `odds[]`). Each odds entry: `market`, `team1Odds`, `team2Odds`, implied probabilities, `marketStatus`, `priceSince` (when that price was set). The market between two rounds is the stretch from one round's `end` to the next round's `start`. Filters: `map`, `round`, `market`. Rounds are recorded from 2026-11-04 for matches with open markets while the match is live; a round with no recorded boundary is absent. Odds are included on Pro and above.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| matchId (path)* | string | Match id, e.g. cs2-match-2398421. |
| map | string | Map number (1, 2, ...): only rows recorded while this map was being played. |
| market | string | One market: h2h (series winner) or map_h2h_1, map_h2h_2, ... |
| round | string | Round number: only rows recorded while this round was being played (or, between rounds, before it started). |
Example
curl "https://api.citoapi.com/api/v1/cs2/matches/MATCH_ID/odds/rounds" \
-H "x-api-key: YOUR_API_KEY"Response
{
"success": true,
"data": {
"dataAvailable": false,
"unavailableReason": "not_yet_indexed",
"dataQuality": "unavailable",
"message": "No per-round odds have been recorded for this match. They are recorded while a match with open markets is live."
},
"meta": {
"count": 0,
"dataAvailable": false,
"limit": 0,
"total": 0,
"page": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}Try the CS2 Odds API
Run a real request with your key, then wire the same call into your app. The free plan includes 500 requests a month.
curl "https://api.citoapi.com/api/v1/cs2/matches/cs2-match-2399722/odds" \
-H "x-api-key: YOUR_API_KEY"