ScinScope docs

Быстрый старт

За пять минут: получить токен, найти позицию в каталоге, посмотреть спред между площадками и завести первое отслеживание.

1. Получите токен

Войдите в панель, откройте раздел «Доступ» и создайте токен. Токен показывается один раз — сохраните его сразу. Область read хватает для всех запросов ниже; область write нужна только для создания отслеживаний.

Authorization: Bearer sst_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. Найдите позицию

Поиск по каталогу принимает свободную строку и сам разбирает качество, если оно указано.

curl -s https://scinscope.com/api/v2/items \
  -H "Authorization: Bearer $TOKEN" \
  --get --data-urlencode "q=AK-47 Redline FT"
{
  "items": [
    {
      "id": "itm_9c1af730",
      "name": "AK-47 | Redline",
      "wear": "ft",
      "quote": 14.62,
      "currency": "USD",
      "trades_24h": 412
    }
  ]
}

3. Посмотрите спред

Основной запрос: где дешевле купить и где дороже продать по этой позиции.

curl -s https://scinscope.com/api/v2/items/itm_9c1af730/spread \
  -H "Authorization: Bearer $TOKEN"
{
  "item": "itm_9c1af730",
  "best": {
    "buy":  { "venue": "venue_c", "price": 13.10 },
    "sell": { "venue": "venue_a", "price": 16.40, "net": 14.35 },
    "spread": 1.25,
    "spread_pct": 9.54,
    "hold_days": 7
  },
  "as_of": "2026-08-26T11:04:12Z"
}

Обратите внимание на net: цена продажи 16.40, но после комиссий до вас дойдёт 14.35. Спред считается от этой суммы, а не от price.

Поле hold_days: 7 означает, что купленный предмет неделю нельзя перепродать. Оценивайте спред с поправкой на то, как позиция ходила за это время — история доступна через /items/{id}/history.

4. Заведите отслеживание

Отслеживание срабатывает, когда появляется лот или спред, подходящий под все условия сразу. Требуется токен с областью write.

curl -s https://scinscope.com/api/v2/watches \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "item": "itm_9c1af730",
    "kind": "spread",
    "min_spread_pct": 8,
    "max_hold_days": 3,
    "min_trades_24h": 50,
    "channels": ["default"]
  }'

Условия min_trades_24h и max_hold_days стоит задавать почти всегда: без них в выдачу попадают неликвидные позиции с формально большим спредом и без покупателя на другой стороне.

5. Принимайте уведомления

На тарифах Plus и Pro доступны вебхуки. Укажите адрес в разделе «Доступ», и на каждое срабатывание придёт POST с подписью тела в заголовке X-ScinScope-Signature.

{
  "event": "watch.matched",
  "watch": "wch_51e0",
  "item": "itm_9c1af730",
  "spread_pct": 11.2,
  "buy":  { "venue": "venue_c", "price": 12.80 },
  "sell": { "venue": "venue_a", "net": 14.24 },
  "at": "2026-08-26T11:31:47Z"
}

Отвечайте на вебхук кодом 2xx в течение пяти секунд. При ошибке доставка повторяется четыре раза с нарастающей паузой, после чего событие отбрасывается.

Что дальше