Обзор

ScinScope сравнивает цены на игровые предметы между торговыми площадками и показывает, где предмет дешевле купить и где дороже продать — с учётом комиссий, сроков вывода и реальной ликвидности. Здесь описаны API, формат данных и правила отслеживания.

Быстрый старт Получить токен и первый спред за пять минут. REST API Каталог, котировки, спреды, отслеживания и вебхуки. Changelog Что изменилось в последних выпусках.

Как это устроено

Сборщик обходит площадки и снимает активные лоты. Нормализатор приводит названия к единому каталогу и складывает историю. Калькулятор считает спред между площадками — уже за вычетом комиссий. Наблюдатель сверяет новые лоты с вашими условиями и отправляет уведомление.

площадки
    |
    v
  сборщик  --(обход, 30–120 с)-->  нормализатор
                                        |
                                        v
                                 каталог и история цен
                                        |
                        +---------------+---------------+
                        v                               v
                 калькулятор спреда              наблюдатель
                 (за вычетом комиссий)                 |
                        |                              v
                        +------------------------> уведомления

Частота обхода зависит от площадки и ликвидности позиции: ходовые предметы проверяются каждые полминуты, редкие — примерно раз в две минуты.

Как считается спред

Спред — это разница между ценой покупки на одной площадке и суммой, которая реально дойдёт до вас после продажи на другой. Комиссия площадки, комиссия вывода и налог вычитаются до сравнения, а не после.

чистая выручка = цена продажи × (1 − комиссия площадки) − комиссия вывода
спред          = чистая выручка − цена покупки
спред, %       = спред ÷ цена покупки × 100

Позиции, где обе стороны сделки не набирают пяти сделок в сутки, из выдачи спредов исключаются. Формально выгодная разница на неликвиде — обычно не возможность, а отсутствие покупателя.

Спред — не гарантия. Между расчётом и сделкой цена меняется, а у большинства площадок есть срок удержания предмета после покупки. Поле hold_days в ответе показывает, сколько дней предмет будет недоступен к перепродаже — на длинном удержании спред часто съедается движением рынка.

Основные понятия

Термин	Что означает
`item`	Позиция каталога: предмет плюс качество. Идентификатор вида `itm_` и восемь символов.
`venue`	Торговая площадка со своей комиссией, сроком вывода и правилами удержания.
`wear`	Категория износа от `fn` до `bs`. Внутри категории цена сильно зависит от точного значения.
`float`	Точное значение износа от 0 до 1. Крайние значения внутри категории торгуются с наценкой.
`pattern`	Номер шаблона отрисовки. Для части предметов влияет на цену сильнее износа.
`listing`	Конкретный лот: площадка, цена, износ, шаблон, наклейки, время появления.
`spread`	Пара площадок для одной позиции с посчитанной чистой разницей.
`watch`	Условие отслеживания. Срабатывает, когда появляется лот или спред под все ограничения.

Сводная цена

Сводная цена позиции — медиана сделок за последние сутки без верхних и нижних пяти процентов. Такой срез устойчив к разовым выбросам и к попыткам нарисовать историю парой встречных сделок.

При числе сделок меньше пяти в сутки сводная цена не считается: в ответе приходит null, а не последняя известная цена. Ориентируйтесь в этом случае на список активных лотов.

Валюта. Внутренний учёт — в USD с точностью до цента. Пересчёт делается по курсу на момент запроса, курс отдаётся в поле rate; сохраняйте его, если нужна воспроизводимость расчёта.

Ограничения

Параметр	Free	Plus	Pro
Запросов в минуту	20	120	600
Активных отслеживаний	5	100	2000
Глубина истории цен	30 дней	2 года	всё время
Вебхуки	нет	да	да

Что поддерживается

Каталог покрывает основные площадки и внутриигровой рынок. Инвентарь читается только по публичному профилю: если профиль скрыт, ScinScope не увидит его содержимое и не станет обходить это ограничение. Автоматических покупок и продаж сервис не совершает — он только показывает данные.