Clutch Data API: CS2 form index, Elo and predictions

A free, open API with the numbers that exist only on Clutch Market: the form index of 312 CS2 pros, Clutch Elo, our model’s chance for every tier-1 match, what the fans picked, and the desk’s predictions with their record. JSON over HTTPS, no key needed to start.

What it is and what the point is

Clutch Market turns every official CS2 map into numbers of its own: a form index for each of 312 pros, a strength rating for the teams, a win chance for every tier-1 match, and a count of what its fans picked before the match started. The API hands these numbers to anyone: the same ones the site shows, at the same moment.

A stats site answers the question “what happened”: the score, the kills, the rating of a map. Our numbers answer the next one, “what does it mean”: who is in form and who is fading, who is the favourite and by how much, whom the crowd believes. To get that yourself you would have to collect every match, write and tune a model, and gather an audience that makes picks. Here it is one request.

The API is free and open: no contract, no card, no key to start. In return we ask for one thing, a link to Clutch Market next to our numbers. That is the whole deal.

What you get here and nowhere else

Schedules, scores and kill tables are sold by stats providers, and we do not resell them. This API carries only what Clutch Market counts itself.

A quote for every pro

One number per player that says how he is playing now, on one scale for all 312 pros from 62 teams. It moves after every official map and keeps its history, so form becomes a line you can draw, sort and compare.

What it is used for: A “who is hot this week” block, a form chart in an article, a bot command, ranking players in a fantasy draft. GET /api/v1/players

Our own strength rating and match chance

Clutch Elo ranks the teams by what they actually won in the last 60 days, and before every tier-1 series it turns into a win chance in percent. It is our own estimate, not a copy of a bookmaker’s line, and you can check it against the result afterwards.

What it is used for: A favourite bar in a match preview, a power ranking in a weekly digest, a second opinion next to your own model. GET /api/v1/teams

What the fans really picked

Not a poll and not likes. Fans back a side in Pick’em with CLUTCH, the game credits they can turn into real CS2 skins, and buy cards on players before the match. You get the share of the pool on each side, the number of fans behind it and the players they back the most. Totals only: no single fan is ever shown.

What it is used for: A “the fans say” line in a preview, comparing the crowd with the model, finding the series where the crowd goes against the favourite. GET /api/v1/matches

Predictions with an open record

Before a tier-1 series the Clutch desk names the winner, the score, the chance and its confidence, with a short reasoning in English, Ukrainian and Russian. After the match the call stays in the record whether it hit or missed, and the record is an endpoint too.

What it is used for: A ready short preview for your channel, and a way to judge us by our results before you rely on us. GET /api/v1/predictions/record

Who of the pros is playing right now

The public Steam and FACEIT status of the listed pros in one list: who is in a game at this moment and in what mode. A player in a game is re-read every 60 seconds.

What it is used for: A “pros online” panel on a stream or in a Discord server, an alert when a favourite player starts a FACEIT match. GET /api/v1/online

A badge with no code at all

A picture that is always up to date: the nickname, the team, the form index and the week’s move. It goes anywhere an image goes, and it needs neither a line of code nor a key.

What it is used for: A team’s fan site, a forum signature, a README, a player’s page in a wiki. GET /api/v1/badge/{id}.svg

Who it is for

  • Streamers and overlay makersShow the form of the ten players of the match on air, the model’s favourite and how the fans split, right on the broadcast. The answers are small and refresh every 15 seconds: a browser source simply asks again. /api/v1/matches, /api/v1/players
  • Discord and Telegram botsA command that answers with a player’s form, a morning post with the movers of the day, a reminder before a match with the model’s chance and the crowd’s pick. While the bot is small it needs no key. /api/v1/players/{id}, /api/v1/market, /api/v1/matches
  • Media, bloggers and channelsNumbers nobody else can quote: “his index grew the most this week”, “most fans are behind them”, “third in Clutch Elo”. Put a form chart into an article, or take the desk’s short preview with a link to the source. /api/v1/players/{id}, /api/v1/teams, /api/v1/matches
  • Fantasy leagues and prediction gamesThe form index is a ready value of a player for a draft or a salary cap, updated after every map. The model’s chance names the favourite without a bookmaker, and the crowd shows what other people think. /api/v1/players, /api/v1/matches
  • Analysts and model buildersA second model to compare yours with, the crowd as a separate signal, and 45 days of index history for every player. Our record is open, so you can measure us before you use us. /api/v1/teams, /api/v1/predictions/record, /api/v1/players/{id}
  • Team and community sitesBadges of the whole roster that update themselves, the team’s place in Clutch Elo, who of the players is in a game right now. A few lines of HTML, no server of your own. /api/v1/badge/{id}.svg, /api/v1/teams, /api/v1/online

Why it is easy to work with

  • No key to start60 requests a minute work at once, with nothing to sign up for. A free key raises that to 600.
  • Straight from the browserCORS is open: a page on any site calls the API directly, with no server of yours in between.
  • A finished numberYou do not collect matches or compute anything. One request returns the value the site itself shows.
  • Always currentQuotes and picks in an answer are at most 15 seconds behind the site. The Clutch index, Elo and the model’s chances are re-counted every 4 minutes.
  • Plain and predictableGET requests, JSON answers, times in ISO 8601 UTC, the same field names in every endpoint. An error is JSON too and says what went wrong.
  • It will not break under youThe version is part of the address. Inside v1 fields are only added; a change that could break your code gets a new version.

How the numbers are made

Form index

Every listed player has a quote in index dollars. After each official map (tiers 1 to 3) we take his rating, ADR and KAST for that map and compare them with what was expected of him: halfway between the average of the pro scene (rating 6.0, ADR 75, KAST 70%) and his own usual level. Rating weighs the most, then ADR, then KAST, and a win adds a little. The result is multiplied by the weight of the event (tier 1 is the heaviest) and of the opponent (a team from the world top 30 weighs more), and the quote moves by that percentage, by 8% a map at most. The starting level of a quote reflects the player’s class: his form over six months, his team’s place in the world ranking and his career prize money. Index dollars are a unit of measure, not money: the index cannot be bought or sold.

The Clutch index

The whole listing as one line. Every quote is divided by its own level 30 days ago and the results are averaged with equal weight, so 100 means “where the listing stood a month ago”. Next to it come the number of players who went up and down in a week, and heat from 0 to 100, which rises when the index grows, when more players go up than down and when many maps are played.

Clutch Elo

All teams start level. Every finished tier-1 series of the last 60 days moves both teams: the winner up, the loser down, and by more when the result was unexpected or the score was one-sided. The table shows the top 16 teams that played at least two such series.

Match chance

For a tier-1 series ahead we take the gap in Clutch Elo, add the recent form of the listed players of both teams, and in a longer series give the stronger side a little more. Where the market publishes a line for the match, the estimate is partly pulled toward it, because a short window of results is noisy. The chance never reaches 0 or 100. For the other tiers the field is empty: we do not publish a number we cannot stand behind.

The crowd

For every series we add up the CLUTCH that fans put on each side in Pick’em and count the fans, and we add up the cards bought on each player. The API gives the share of the pool, the number of fans and the most backed players. While nobody has picked, the field is empty rather than zero.

The desk’s predictions

Before each tier-1 series the desk writes its call from a sheet of our own figures: Elo, form, map records, head-to-head, the market line and the crowd. The pick follows the model’s favourite unless the match is close to even, and the stated chance stays near the model’s. Once the series is played, the call goes into the record and is not edited or removed.

Endpoints

GET /api/v1/market: The Clutch index

The whole listing as one number: the equal-weighted index of all 312 pros, its change over 1, 7 and 30 days, 30 daily points for a chart, how many players went up and down in a week, a 0 to 100 heat reading, and the biggest movers of the week.

GET /api/v1/players: Form index of every pro

All 312 listed pros with their form index: a quote in index dollars that moves after every official map the player finishes (tiers 1 to 3, tier 1 weighs the most), with the change over 24 hours and 7 days and the place in the listing.

  • teamonly players of one team, by its name (Vitality)
  • sortindex (default), change24h or change7d; add a minus for the reverse order (-change7d)
  • limithow many rows, 1 to 312 (default: all)

GET /api/v1/players/{id}: One player, map by map

One pro in full: the quote, and every map of the last 45 days that moved it (when, which map, against whom, the tier, won or lost, the move in percent and the index after it), plus whether he is in a game right now.

GET /api/v1/teams: Clutch Elo: team power ranking

Our own Elo, counted from every finished tier-1 series of the last 60 days with the margin of the score taken into account: the top 16 teams with their rating, series and map records, the last five results and their listed players.

GET /api/v1/matches: Matches: model, crowd and the desk’s call

Series on air and ahead, all tiers. For each one: where the fans put their CLUTCH in Pick’em (share of the pool and how many fans picked) and which players they back with cards. Tier-1 series also carry our model’s win chance (Clutch Elo blended with the form of the listed players) and the desk’s prediction: the pick, the score, the chance and the confidence.

  • tier1, 2 or 3: only series of that tier
  • statuslive or upcoming
  • limithow many series, 1 to 60 (default 60)
  • langen (default), uk or ru: the language of the desk’s text

GET /api/v1/matches/{id}: One series

The same card for one series by its id, with the desk’s full reasoning (three factors and the risk) and, once it is played, the score and whether the call was right.

  • langen (default), uk or ru

GET /api/v1/predictions/record: The desk’s track record

Every call is kept after the match: the latest 40 settled tier-1 series with the pick, the real score, whether the winner was right and whether the exact score was, and the totals. Nothing is removed after a miss.

GET /api/v1/online: Pros in a game right now

Which of the listed pros are playing at this moment and in what mode (Premier, matchmaking, FACEIT and so on), read from their public Steam and FACEIT status. A player in a game is re-read every 60 seconds. A hidden profile shows nothing, and an official match is not visible this way.

GET /api/v1/badge/{id}.svg: A player badge for your page

A ready picture (SVG) with the player’s nickname, team, form index and its change over 7 days. Put it into a site, a forum signature or a README as an ordinary image: it always shows the current numbers.

Key and limits

Without a key: 60 requests a minute from one address. With a free key (header x-api-key): 600 requests a minute. Answers are JSON and open to any site (CORS); quotes and picks are at most 15 seconds behind the site.

Questions before you start

Can I use it in a commercial project?

Yes. A paid app, a monetised channel, a media site: all fine, as long as the source is named with a link where the numbers are shown.

Do I need a key?

No. 60 requests a minute work without one. Make a key when many of your users share one address or when you need more: it is free and gives 600 a minute.

How fresh are the numbers?

Quotes and picks are at most 15 seconds behind the site, so asking more often returns the same thing. The form index itself changes when the official stats of a finished map are published. The Clutch index, Elo and the model’s chances are re-counted every 4 minutes.

What are index dollars? Can the index be bought?

No. The dollar sign is a unit that makes quotes easy to compare, like points. Nothing is bought or sold at these quotes, and the index is not an asset or an investment.

Where do the match stats behind the index come from?

From the official statistics of professional matches: each player’s rating, ADR and KAST for a map. Clutch Market counts its index from them and does not pass them on: for raw match data go to a stats provider.

Why are some fields null?

The crowd is empty until the first fan picks. The model’s chance and the desk’s prediction exist only for tier-1 series. A player’s status is “unknown” when Steam has not answered about him for a while.

Will the fields change under me?

Inside v1 fields are only added. If a field ever has to go or change its meaning, that will be a new version at a new address, announced on this page.

I need more requests, another field or a live feed.

Write to us and say what you are building: limits and new fields are discussed case by case.

Terms of use

Why it is free. Clutch Market is a young project, and the best thing that can happen to our numbers is that people see them: on a stream, in a bot, in an article. Every such place leads back to us, and that is worth more to us than a subscription fee. There is no trial period and no paid plan.

  • Free, for any project, commercial ones included.
  • Wherever you show our numbers, name the source with a link: “Data: Clutch Market”, leading to clutch-market.com.
  • Keep what you received for at least 15 seconds: the answer does not change more often.
  • The index, the model and the predictions are statistics and opinion for entertainment, not betting or investment advice. The data comes as it is.