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 або upcominglimitскільки серій, від 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 секунд: відповідь не змінюється частіше.
- Індекс, модель і прогнози є статистикою та думкою для розваги, а не порадою щодо ставок чи інвестицій. Дані надаються як є.