Options Screener API v2

API для получения данных по криптовалютным опционам с Binance.

Доступ к API

API доступен по адресу https://options.szhub.space через Nginx (проксирует на порт 8080).

WebSocket: wss://options.szhub.space

Сервер

IP: 76.13.138.220
Порт: 8080 (внутренний), 80 (Nginx)
Пользователь: app
Путь: /home/app/options-backend

Подключение к серверу

ssh root@76.13.138.220
su - app
cd /home/app/options-backend

Управление сервисом

pm2 status          # статус
pm2 logs options    # логи
pm2 restart options # перезапуск
pm2 stop options    # остановка
pm2 start index.js --name options  # запуск

API Endpoints

Health Check (публичный)

GET /health

Список дат экспирации

GET /api/expiries
Header: x-api-key: my_secret_key_12345

Статистика

GET /api/summary
Header: x-api-key: my_secret_key_12345

Опционы с фильтрами

GET /api/options
Header: x-api-key: my_secret_key_12345

Доступные фильтры

Параметр	Описание	Пример
underlying	Базовый актив	BTC, ETH
type	Тип опциона	CALL, PUT
expiry	Дата экспирации	260207
minVolume	Мин. объём	100
maxVolume	Макс. объём	1000
minDelta	Мин. дельта	0.4
maxDelta	Макс. дельта	0.6
minGamma	Мин. гамма	0.001
maxGamma	Макс. гамма	0.01
minTheta	Мин. тета	-500
maxTheta	Макс. тета	-100
minVega	Мин. вега	5
maxVega	Макс. вега	20
minIV	Мин. implied volatility	0.5
maxIV	Макс. implied volatility	2.0

Top Movers (лидеры роста/падения)

GET /api/top-movers
Header: x-api-key: my_secret_key_12345

Параметры

Параметр	Описание	По умолчанию
limit	Кол-во записей в каждой категории	10
underlying	Фильтр по базовому активу (BTC, ETH)	все

Пример ответа

{
  "lastUpdate": "2026-02-07T10:00:00.000Z",
  "limit": 10,
  "gainers": [
    {
      "symbol": "BTC-260214-100000-C",
      "priceChange": "1200",
      "priceChangePercent": "45.5",
      "lastPrice": "3840",
      "volume": "25.10"
    }
  ],
  "losers": [
    {
      "symbol": "ETH-260207-3000-P",
      "priceChange": "-800",
      "priceChangePercent": "-60.2",
      "lastPrice": "530",
      "volume": "12.50"
    }
  ]
}

Unusual Volume (аномальный объём)

GET /api/unusual-volume
Header: x-api-key: my_secret_key_12345

Параметры

Параметр	Описание	По умолчанию
underlying	Фильтр по базовому активу (BTC, ETH)	все
limit	Макс. кол-во записей	20

Пример ответа

{
  "lastUpdate": "2026-02-07T10:00:00.000Z",
  "avgVolume": 15.3,
  "threshold": 30.6,
  "count": 5,
  "data": [
    {
      "symbol": "BTC-260214-100000-C",
      "volume": "120.50",
      "lastPrice": "3840",
      "priceChange": "500",
      "ratio": 7.88
    }
  ]
}

WebSocket

Real-time обновления данных по опционам через WebSocket.

Подключение

wss://options.szhub.space

Каналы

Канал	Описание
`BTC`	Все опционы на BTC
`ETH`	Все опционы на ETH
`all`	Все опционы (BTC + ETH)
`top-movers`	Лидеры роста и падения
`unusual-volume`	Опционы с аномальным объёмом

Подписка на канал

Отправить JSON-сообщение:

{"subscribe": "BTC"}

Отписка от канала

{"unsubscribe": "BTC"}

Формат ответа сервера

{
  "channel": "BTC",
  "data": { ... },
  "timestamp": "2026-02-07T10:00:00.000Z"
}

Heartbeat

Сервер отправляет ping каждые 30 секунд для поддержания соединения. Клиент должен отвечать pong.

Пример подключения (JavaScript)

const ws = new WebSocket("wss://options.szhub.space");

ws.onopen = () => {
  ws.send(JSON.stringify({ subscribe: "BTC" }));
  ws.send(JSON.stringify({ subscribe: "top-movers" }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  console.log(`[${msg.channel}]`, msg.data);
};

Примеры запросов

# Health check
curl https://options.szhub.space/health

# Все опционы
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/options"

# BTC CALL опционы
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/options?underlying=BTC&type=CALL"

# Опционы на конкретную дату
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/options?underlying=BTC&expiry=260207"

# ATM опционы (delta 0.4-0.6)
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/options?underlying=BTC&minDelta=0.4&maxDelta=0.6"

# Опционы с высоким объёмом
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/options?minVolume=100"

# Top movers — BTC, топ 5
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/top-movers?underlying=BTC&limit=5"

# Unusual volume
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/unusual-volume?underlying=ETH&limit=10"

# Список экспираций
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/expiries"

# Статистика
curl -H "x-api-key: my_secret_key_12345" \
  "https://options.szhub.space/api/summary"

Структура ответа /api/options

{
  "lastUpdate": "2026-02-06T07:26:24.667Z",
  "count": 2,
  "filters": {"underlying": "BTC", "type": "CALL"},
  "data": [
    {
      "symbol": "BTC-260207-65000-C",
      "priceChange": "-955",
      "lastPrice": "1500",
      "volume": "15.89",
      "greeks": {
        "delta": "0.52129532",
        "gamma": "0.00010023",
        "theta": "-773.64478105",
        "vega": "13.73117089",
        "markIV": "1.16488146"
      }
    }
  ]
}

Файлы проекта

/home/app/options-backend/
├── index.js       # Основной код API + WebSocket
├── package.json   # Зависимости
├── .env           # Конфигурация (PORT, API_KEY)
├── .gitignore     # Игнорируемые файлы
└── README.md      # Документация

.env файл

PORT=8080
API_KEY=my_secret_key_12345

Git репозиторий

https://github.com/Zserg5585/option-screener-v1

git add .
git commit -m "описание изменений"
git push

Dashboard — первый экран

GET /api/dashboard
Header: x-api-key: <key>

Агрегирует все сигналы в одном ответе, отсортированных по confidence (0–95).

Источники сигналов

Тип	Стратегия	Откуда
Классические стратегии	Long/Short Straddle, Iron Condor, Bull Call Spread, Bear Put Spread, Calendar Spread, Covered Call, Protective Put, Butterfly	strategies.js
Аномальный объём	Unusual Volume (VOI ≥ 5×)	unusualVolume.js
Гамма-игра	Gamma Play (EXTREME/HIGH)	gammaPlay.js
IV Skew	BULLISH / STRONG_BEARISH	ivSkew.js

Формат сигнала

{
  "id": "bull_call_spread_btc",
  "strategy": "Bull Call Spread",
  "signal": "BUY_BULL_CALL_SPREAD",
  "underlying": "BTC",
  "direction": "BULLISH",
  "confidence": 73,
  "severity": "HIGH",
  "parameters": {
    "pcrAvg": 0.45,
    "skew25d": -0.06,
    "ivRank": 52.3,
    "spot": 95000
  },
  "description": "Bull Call Spread по BTC: покупка ATM call + продажа OTM call",
  "rationale": "PCR 0.45 — сильный бычий сигнал. Negative skew (-0.060) — рынок покупает upside. Max pain выше текущей цены.",
  "timestamp": "2026-02-26T10:00:00.000Z"
}

Значения `direction`

Значение	Смысл
`BULLISH`	Направленная ставка вверх
`BEARISH`	Направленная ставка вниз
`NEUTRAL`	Рыночно-нейтральная стратегия
`NEUTRAL_VOLATILE`	Нейтральная, выигрывает на движении
`NEUTRAL_RANGE`	Нейтральная, выигрывает во флэте
`NEUTRAL_BULLISH`	Нейтральная с бычьим уклоном
`BULLISH_HEDGED`	Бычья позиция с хеджем

TODO

~~Добавить эндпоинт top gainers/losers~~
~~Добавить эндпоинт unusual volume~~
~~Добавить WebSocket для real-time данных~~
~~Настроить Nginx для внешнего доступа~~
~~Разбить код на модули (routes, services)~~
~~Классические опционные стратегии + dashboard-эндпоинт~~

Roadmap

v2.1 — Реальный IV Rank (приоритет: высокий)

Сейчас ivRank считается по внутридневному срезу опционов. Для настоящего IV Rank нужна 30-дневная история.

Хранить снапшоты ATM IV в PostgreSQL каждые 5 мин
Считать ivRank и ivPercentile по реальной 30-дневной истории
Отдавать исторический IV в /api/signals/iv-analysis

v2.2 — Алерты (приоритет: высокий)

Telegram-бот: уведомление когда confidence ≥ 75
Webhook endpoint: POST на внешний URL при новом сигнале
Дедупликация: не слать повторный алерт по одному сигналу < 30 мин

v2.3 — WebSocket канал `dashboard`

Добавить канал dashboard в WebSocket
Пушить обновлённый dashboard каждые 5 мин вместе с остальными каналами

v2.4 — Deribit как второй источник данных

Подключить Deribit API (более ликвидный рынок для ETH)
Унифицировать формат данных между биржами
Добавить поле exchange в каждый опцион

v2.5 — Бэктестинг сигналов

Сохранять сигналы в PostgreSQL с timestamp и confidence
Через N дней после экспири помечать outcome (прибыль/убыток)
Endpoint /api/backtest — статистика точности по стратегиям

v2.6 — Фронтенд

React/Next.js дашборд, потребляющий /api/dashboard + WebSocket
Карточки сигналов: цвет по severity, индикатор confidence
Тепловая карта OI по страйкам

v2.7 — Дополнительные улучшения

Pagination для /api/options (сейчас отдаёт весь массив)
Redis-кэш вместо in-memory (масштабируемость)
Логирование в файл с ротацией (winston + daily-rotate-file)
Uptime-мониторинг (healthcheck + Telegram alert при падении)
Rate limit по API-ключу (сейчас глобальный лимит)

Options Screener API v2

Доступ к API

Сервер

Подключение к серверу

Управление сервисом

API Endpoints

Health Check (публичный)

Список дат экспирации

Статистика

Опционы с фильтрами

Доступные фильтры

Top Movers (лидеры роста/падения)

Параметры

Пример ответа

Unusual Volume (аномальный объём)

Параметры

Пример ответа

WebSocket

Подключение

Каналы

Подписка на канал

Отписка от канала

Формат ответа сервера

Heartbeat

Пример подключения (JavaScript)

Примеры запросов

Структура ответа /api/options

Файлы проекта

.env файл

Git репозиторий

Dashboard — первый экран

Источники сигналов

Формат сигнала

Значения direction

TODO

Roadmap

v2.1 — Реальный IV Rank (приоритет: высокий)

v2.2 — Алерты (приоритет: высокий)

v2.3 — WebSocket канал dashboard

v2.4 — Deribit как второй источник данных

v2.5 — Бэктестинг сигналов

v2.6 — Фронтенд

v2.7 — Дополнительные улучшения

📜 Git History

Значения `direction`

v2.3 — WebSocket канал `dashboard`