Clutch Data API: индекс формы CS2, Elo и прогнозы

Бесплатный открытый API с числами, которые есть только на Clutch Market: индекс формы 312 профи CS2, Clutch Elo, шанс нашей модели на каждый матч тир-1, выбор фанатов и прогнозы редакции с их историей. JSON по HTTPS, для начала ключ не нужен.

Что это и в чём смысл

Clutch Market превращает каждую официальную карту CS2 в собственные числа: индекс формы для каждого из 312 профи, рейтинг силы команд, шанс победы в каждом матче тир-1 и подсчёт того, что фанаты выбрали до начала матча. API отдаёт эти числа любому желающему: те же, что показывает сайт, и в тот же момент.

Сайт статистики отвечает на вопрос «что произошло»: счёт, фраги, рейтинг за карту. Наши числа отвечают на следующий, «что это значит»: кто в форме, а кто сдаёт, кто фаворит и насколько, кому верит толпа. Чтобы получить это самому, пришлось бы собирать каждый матч, писать и настраивать модель и собирать аудиторию, которая делает выбор. Здесь это один запрос.

API бесплатный и открытый: без договора, без карты, для начала даже без ключа. Взамен просим одно: ссылку на Clutch Market рядом с нашими числами. Это вся сделка.

Что есть здесь и больше нигде

Расписание, счёт и таблицы фрагов продают поставщики статистики, и мы их не перепродаём. В этом API только то, что Clutch Market считает сам.

Котировка каждого профи

Одно число на игрока, которое говорит, как он играет сейчас, на одной шкале для всех 312 профи из 62 команд. Оно двигается после каждой официальной карты и хранит историю, так что форма превращается в линию, которую можно нарисовать, отсортировать и сравнить.

Для чего это берут: Блок «кто в ударе на этой неделе», график формы в статье, команда бота, сортировка игроков в фэнтези-драфте. GET /api/v1/players

Свой рейтинг силы и шанс в матче

Clutch Elo расставляет команды по тому, что они реально выиграли за последние 60 дней, а перед каждой серией тир-1 превращается в шанс победы в процентах. Это наша собственная оценка, а не копия линии букмекера, и после матча её можно сверить с результатом.

Для чего это берут: Полоса фаворита в анонсе матча, рейтинг силы в еженедельной сводке, второе мнение рядом с твоей моделью. GET /api/v1/teams

Что на самом деле выбрали фанаты

Не опрос и не лайки. Фанаты выбирают сторону в Pick’em за CLUTCH, игровые кредиты, которые можно обменять на настоящие скины CS2, и покупают карточки игроков до матча. Ты получаешь долю пула на каждой стороне, число фанатов за ней и игроков, которых поддерживают больше всего. Только суммы: отдельный фанат не показывается никогда.

Для чего это берут: Строка «фанаты считают» в анонсе, сравнение толпы с моделью, поиск серий, где толпа идёт против фаворита. GET /api/v1/matches

Прогнозы с открытой историей

Перед серией тир-1 редакция Clutch называет победителя, счёт, шанс и свою уверенность, с коротким обоснованием на английском, украинском и русском. После матча прогноз остаётся в истории, попал он или промахнулся, и эта история тоже доступна по API.

Для чего это берут: Готовый короткий анонс для твоего канала и возможность оценить нас по результатам, прежде чем на нас опираться. GET /api/v1/predictions/record

Кто из профи играет прямо сейчас

Публичный статус профи из листинга в Steam и FACEIT одним списком: кто в игре в эту минуту и в каком режиме. Игрока в игре перечитываем каждые 60 секунд.

Для чего это берут: Панель «профи онлайн» на стриме или в Discord-сервере, оповещение, когда любимый игрок начал матч на FACEIT. GET /api/v1/online

Бейдж вообще без кода

Картинка, которая всегда актуальна: ник, команда, индекс формы и движение за неделю. Вставляется везде, куда вставляется изображение, и для неё не нужно ни строчки кода, ни ключа.

Для чего это берут: Фан-сайт команды, подпись на форуме, README, страница игрока в вики. GET /api/v1/badge/{id}.svg

Кому это нужно

  • Стримерам и авторам оверлеевПокажи прямо в трансляции форму десяти игроков матча, фаворита по модели и то, как разделились фанаты. Ответы маленькие и обновляются каждые 15 секунд: источнику-браузеру достаточно спрашивать снова. /api/v1/matches, /api/v1/players
  • Ботам в Discord и TelegramКоманда, которая отвечает формой игрока, утренний пост с лидерами движения за день, напоминание перед матчем с шансом по модели и выбором толпы. Пока бот маленький, ключ не нужен. /api/v1/players/{id}, /api/v1/market, /api/v1/matches
  • Медиа, блогерам и каналамЧисла, которые больше никто не процитирует: «его индекс вырос за неделю сильнее всех», «большинство фанатов за них», «третьи в Clutch Elo». Поставь график формы в статью или возьми короткий анонс редакции со ссылкой на источник. /api/v1/players/{id}, /api/v1/teams, /api/v1/matches
  • Фэнтези-лигам и играм на прогнозыИндекс формы это готовая стоимость игрока для драфта или потолка зарплат, обновляемая после каждой карты. Шанс по модели называет фаворита без букмекера, а толпа показывает, что думают другие. /api/v1/players, /api/v1/matches
  • Аналитикам и авторам моделейВторая модель, чтобы сравнить со своей, толпа как отдельный сигнал и 45 дней истории индекса по каждому игроку. Наша история прогнозов открыта, так что нас можно измерить, прежде чем использовать. /api/v1/teams, /api/v1/predictions/record, /api/v1/players/{id}
  • Сайтам команд и сообществБейджи всего состава, которые обновляются сами, место команды в Clutch Elo, кто из игроков сейчас в игре. Несколько строк HTML, свой сервер не нужен. /api/v1/badge/{id}.svg, /api/v1/teams, /api/v1/online

Почему с ним легко работать

  • Старт без ключа60 запросов в минуту работают сразу, без какой-либо регистрации. Бесплатный ключ поднимает это до 600.
  • Прямо из браузераCORS открыт: страница любого сайта вызывает API напрямую, без твоего сервера посередине.
  • Готовое числоНе нужно собирать матчи и что-то считать. Один запрос возвращает значение, которое показывает сам сайт.
  • Всегда актуальноКотировки и выбор фанатов в ответе отстают от сайта не больше чем на 15 секунд. Индекс Clutch, Elo и шансы модели пересчитываются каждые 4 минуты.
  • Просто и предсказуемоЗапросы GET, ответы в JSON, время в формате ISO 8601 UTC, одинаковые названия полей в каждом эндпоинте. Ошибка тоже приходит в JSON и говорит, что пошло не так.
  • Не сломается под тобойВерсия является частью адреса. Внутри v1 поля только добавляются; изменение, которое может сломать твой код, получает новую версию.

Как считаются числа

Индекс формы

У каждого игрока из листинга есть котировка в долларах индекса. После каждой официальной карты (тир-1, тир-2 и тир-3) мы берём его рейтинг, ADR и KAST за эту карту и сравниваем с тем, чего от него ждали: середина между средним по про-сцене (рейтинг 6.0, ADR 75, KAST 70%) и его собственным обычным уровнем. Больше всего весит рейтинг, затем ADR, затем KAST, победа добавляет немного. Результат умножается на вес турнира (тир-1 самый тяжёлый) и соперника (команда из мирового топ-30 весит больше), и котировка сдвигается на этот процент, не больше чем на 8% за карту. Стартовый уровень котировки отражает класс игрока: форму за полгода, место команды в мировом рейтинге и призовые за карьеру. Доллары индекса это единица измерения, а не деньги: индекс нельзя купить или продать.

Индекс Clutch

Весь листинг одной линией. Каждая котировка делится на свой уровень 30 дней назад, и результаты усредняются с равным весом, так что 100 означает «где листинг был месяц назад». Рядом идут число игроков, которые за неделю выросли и упали, и «температура» от 0 до 100, которая растёт, когда растёт индекс, когда растущих игроков больше, чем падающих, и когда играется много карт.

Clutch Elo

Все команды начинают с одного уровня. Каждая завершённая серия тир-1 за последние 60 дней сдвигает обе команды: победителя вверх, проигравшего вниз, и сильнее, когда результат был неожиданным или счёт разгромным. В таблице топ-16 команд, сыгравших хотя бы две такие серии.

Шанс в матче

Для предстоящей серии тир-1 мы берём разницу в Clutch Elo, добавляем свежую форму игроков из листинга обеих команд, а в длинной серии даём сильной стороне чуть больше. Там, где рынок публикует линию на матч, оценка частично подтягивается к ней, потому что короткое окно результатов шумит. Шанс никогда не доходит до 0 или 100. Для остальных тиров поле пустое: мы не публикуем число, за которое не можем отвечать.

Толпа

По каждой серии мы складываем CLUTCH, которые фанаты отдали за каждую сторону в Pick’em, и считаем фанатов, а также складываем карточки, купленные на каждого игрока. API отдаёт долю пула, число фанатов и самых поддерживаемых игроков. Пока никто не выбрал, поле пустое, а не нулевое.

Прогнозы редакции

Перед каждой серией тир-1 редакция пишет прогноз по листу наших собственных цифр: Elo, форма, статистика по картам, личные встречи, линия рынка и выбор толпы. Выбор следует за фаворитом модели, если матч не близок к равному, а названный шанс остаётся рядом с шансом модели. Как только серия сыграна, прогноз уходит в историю и больше не правится и не удаляется.

Эндпоинты

GET /api/v1/market: Индекс Clutch

Весь листинг одним числом: равновзвешенный индекс всех 312 профи, его изменение за 1, 7 и 30 дней, 30 дневных точек для графика, сколько игроков за неделю выросло и упало, показатель «температуры» от 0 до 100 и лидеры движения за неделю.

GET /api/v1/players: Индекс формы каждого профи

Все 312 профи из листинга и их индекс формы: котировка в долларах индекса, которая меняется после каждой официальной карты игрока (тир-1, тир-2 и тир-3, тир-1 весит больше всего), с изменением за 24 часа и 7 дней и местом в листинге.

  • teamтолько игроки одной команды, по названию (Vitality)
  • sortindex (по умолчанию), change24h или change7d; минус впереди разворачивает порядок (-change7d)
  • limitсколько строк, от 1 до 312 (по умолчанию: все)

GET /api/v1/players/{id}: Один игрок, карта за картой

Один профи целиком: котировка и каждая карта за последние 45 дней, которая её сдвинула (когда, какая карта, против кого, тир, победа или поражение, изменение в процентах и индекс после неё), а также в игре ли он прямо сейчас.

GET /api/v1/teams: Clutch Elo: рейтинг силы команд

Наш собственный Elo, посчитанный по всем завершённым сериям тир-1 за последние 60 дней с учётом разницы в счёте: топ-16 команд с рейтингом, балансом серий и карт, последними пятью результатами и игроками из листинга.

GET /api/v1/matches: Матчи: модель, толпа и прогноз редакции

Серии в эфире и впереди, все тиры. Для каждой: куда фанаты поставили CLUTCH в Pick’em (доля пула и сколько фанатов выбрали сторону) и каких игроков они поддержали карточками. Для серий тир-1 есть ещё шанс победы по нашей модели (Clutch Elo плюс форма игроков из листинга) и прогноз редакции: выбор, счёт, шанс и уверенность.

  • tier1, 2 или 3: только серии этого тира
  • statuslive или upcoming
  • limitсколько серий, от 1 до 60 (по умолчанию 60)
  • langen (по умолчанию), uk или ru: язык текста редакции

GET /api/v1/matches/{id}: Одна серия

Та же карточка для одной серии по её id, с полным обоснованием редакции (три фактора и риск), а после матча со счётом и тем, сбылся ли прогноз.

  • langen (по умолчанию), uk или ru

GET /api/v1/predictions/record: История прогнозов редакции

Каждый прогноз остаётся после матча: последние 40 сыгранных серий тир-1 с выбором, настоящим счётом, тем, угадан ли победитель и точный счёт, и итогами. После промаха ничего не убирается.

GET /api/v1/online: Профи в игре прямо сейчас

Кто из профи из листинга играет прямо сейчас и в каком режиме (Premier, матчмейкинг, FACEIT и так далее), по их публичному статусу в Steam и FACEIT. Игрока в игре перечитываем каждые 60 секунд. Скрытый профиль ничего не показывает, а официальный матч так не виден.

GET /api/v1/badge/{id}.svg: Бейдж игрока для твоей страницы

Готовая картинка (SVG) с ником игрока, командой, индексом формы и его изменением за 7 дней. Вставь её на сайт, в подпись на форуме или в README как обычное изображение: она всегда показывает актуальные числа.

Ключ и лимиты

Без ключа: 60 запросов в минуту с одного адреса. С бесплатным ключом (заголовок x-api-key): 600 запросов в минуту. Ответы в JSON и открыты для любого сайта (CORS); котировки и выбор фанатов отстают от сайта не больше чем на 15 секунд.

Вопросы перед стартом

Можно ли использовать в коммерческом проекте?

Да. Платное приложение, монетизированный канал, медиа: всё в порядке, если там, где показаны числа, указан источник со ссылкой.

Нужен ли ключ?

Нет. 60 запросов в минуту работают без него. Создай ключ, когда у многих твоих пользователей один адрес или когда нужно больше: он бесплатный и даёт 600 в минуту.

Насколько свежие числа?

Котировки и выбор фанатов отстают от сайта не больше чем на 15 секунд, так что более частые запросы вернут то же самое. Сам индекс формы меняется, когда опубликована официальная статистика сыгранной карты. Индекс Clutch, Elo и шансы модели пересчитываются каждые 4 минуты.

Что такое доллары индекса? Можно ли купить индекс?

Нет. Знак доллара это единица, которая делает котировки удобными для сравнения, как баллы. По этим котировкам ничего не покупают и не продают, и индекс не является активом или инвестицией.

Откуда берётся статистика матчей для индекса?

Из официальной статистики профессиональных матчей: рейтинг, ADR и KAST каждого игрока за карту. По ним Clutch Market считает свой индекс и дальше их не передаёт: за сырыми данными матчей обращайся к поставщику статистики.

Почему некоторые поля равны null?

Толпа пустая, пока не выберет первый фанат. Шанс по модели и прогноз редакции есть только для серий тир-1. Статус игрока «unknown», когда Steam давно о нём не отвечал.

Поменяются ли поля без предупреждения?

Внутри v1 поля только добавляются. Если поле когда-нибудь придётся убрать или изменить его смысл, это будет новая версия по новому адресу, о которой мы сообщим на этой странице.

Мне нужно больше запросов, другое поле или живой поток.

Напиши нам и расскажи, что ты делаешь: лимиты и новые поля обсуждаем отдельно для каждого проекта.

Условия использования

Почему бесплатно. Clutch Market молодой проект, и лучшее, что может случиться с нашими числами, это чтобы их увидели: на стриме, в боте, в статье. Каждое такое место ведёт обратно к нам, и для нас это ценнее абонентской платы. Пробного периода и платного тарифа нет.

  • Бесплатно, для любого проекта, в том числе коммерческого.
  • Там, где показываешь наши числа, укажи источник со ссылкой: «Данные: Clutch Market» на clutch-market.com.
  • Храни полученное хотя бы 15 секунд: ответ не меняется чаще.
  • Индекс, модель и прогнозы являются статистикой и мнением для развлечения, а не советом по ставкам или инвестициям. Данные предоставляются как есть.