Docs/CS2 API/CS2 Odds API

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

GET/api/v1/cs2/matches/{matchId}/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

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.
limitintegerRows to return. Maximum 200; larger values are reduced to 200.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/matches/MATCH_ID/odds" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "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

GET/api/v1/cs2/matches/{matchId}/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

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.
limitintegerRows (default 500, max 2000). Maximum 2000; larger values are reduced to 2000.
mapstringMap number (1, 2, ...): only rows recorded while this map was being played.
marketstringOne market: h2h (series winner) or map_h2h_1, map_h2h_2, ...
orderstringasc (default, oldest first) or desc.
phasestringin_round, between_rounds or map_over.
roundstringRound number: only rows recorded while this round was being played (or, between rounds, before it started).
sincestringISO time: only changes at or after it.

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/matches/MATCH_ID/odds/history" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "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

GET/api/v1/cs2/matches/{matchId}/odds/rounds

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

ParameterTypeDescription
matchId (path)*stringMatch id, e.g. cs2-match-2398421.
mapstringMap number (1, 2, ...): only rows recorded while this map was being played.
marketstringOne market: h2h (series winner) or map_h2h_1, map_h2h_2, ...
roundstringRound number: only rows recorded while this round was being played (or, between rounds, before it started).

Example

bash
curl "https://api.citoapi.com/api/v1/cs2/matches/MATCH_ID/odds/rounds" \
  -H "x-api-key: YOUR_API_KEY"

Response

json
{
  "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.

bash
curl "https://api.citoapi.com/api/v1/cs2/matches/cs2-match-2399722/odds" \
  -H "x-api-key: YOUR_API_KEY"
Was this page helpful?