API котировок

Сервис котировок — слой, из которого терминал, тикер и свечной график узнают цену. Платформа БО или Forex цену сама не рисует: она потребляет ленту тиков или баров. Когда график замер, начинают с API и символов, а не с перекраски кнопки ордера.

В линейке Microscript «quotes» — это продуктовый контур market data: REST/WS, словарь инструментов, витрина и точки подключения для торговых скриптов. Рядом живут CoinMarket-таблица, Fear & Greed, тикер и TradingView datafeed — все читают одну правду рынка, если вы не развели их по разным костылям.

Из чего состоит лента

• Снапшот рынка: last, изменение, объём — для таблицы и тикера.
• История свечей — для графика и бэкпроверки.
• Поток тиков — для live-обновления последней цены и текущего бара.
• Справочник символов — единые id для всех виджетов.

Документация API и проверки доступа — API котировок. Поток без лишнего polling — WebSocket. Отрисовка — TradingView Library и графики крипты.

Если график пустой

1. Откройте ответ API: есть ли свежая метка времени.
2. Сверьте символ: EURUSD и EUR/USD часто разные имена.
3. Проверьте, что домен платформы видит хост котировок; локальный .loc с другой машины может не резолвиться.
4. Посмотрите CORS и смешанный HTTP/HTTPS.
5. Убедитесь, что виджет подписан на символ, который реально есть в справочнике.

Витрина и виджеты

Таблица рынка и капитализация — CoinMarket-скрипт. Бегущая строка — тикер. Индекс настроения — Fear & Greed. Не подключайте к каждому виджету свой «временный» источник: через спринт цены разъедутся, поддержка начнёт ловить «у вас на главной одно, в терминале другое».

Кэш витрины короткий и честный. Торговый поток — свежее. Путать их нельзя: экспирация БО по минутной цене из HTML-кэша — прямой путь к спорам о выплате.

Потребители: БО и Forex

Бинарные опционы берут цену входа и цену на экспирации. Forex считает PnL, маржу и своп по непрерывному потоку. Оба контура садятся на одну ленту, но с разной критичностью к задержке и к полноте стакана (если стакан есть). Продукты: платформа БО, скрипт опционов, Forex, скрипт Forex.

White-label кабинет и терминал должны жить на домене, которому лента разрешена в whitelist. Оболочка бренда: white label. Терминал как UI: торговый терминал.

Эксплуатация

Держите метрики: возраст последнего тика по ключевым символам, ошибки апстрима, число активных WS-подписок. Алерт «stale > N секунд» экономит часы. Логируйте маппинг символов при 404 instrument — это частая причина после добавления новой пары в кабинете и забытого alias в API.

На VDS следите за диском и временем сервера: уехавший NTP ломает «свежесть» сильнее, чем кажется. Панель управления машиной — MicroPanel. Бэкап конфигов словаря символов делайте вместе с БД сайта.

Локальный стенд

На MicroServer поднимите витрину и укажите API явно в конфиге. Проверьте hosts. Смонтируйте document root через SFTP-диск для быстрой правки шаблонов: MicroDrive. Точечный SQL по таблице инструментов — MicroEditor.

Отдельный мини-стенд datafeed+график без кабинета ускоряет диагностику: если стенд живой, а кабинет нет — проблема в продуктовом маппинге, не в market data.

Приёмка ленты

Сдайте: список символов, URL REST, URL WS, интервалы, порог stale, пример кадра тика и свечи, домены whitelist. Видео: тик двигает last в таблице и на графике одновременно. Учебная сделка в демо с проверкой цены в истории — уже стык с торговлей, но без него заказчик всё равно придёт на следующий день.

Демо и real балансы ленту не меняют — меняют только права на ордер и вывод. Но путать пользователя копирайтом «реальные курсы / игрушечный счёт» не стоит: курсы реальные, деньги на демо виртуальные. См. демо-счёт.

Котировки — фундамент всех экранов, где мигает цена. Соберите один контур данных, подключите виджеты и терминалы к нему, мониторьте stale — и перестанете чинить «график» там, где умерла лента.

Словарь инструментов как контракт

Заведите одну таблицу или конфиг: id, отображаемое имя, тип (crypto/forex/stock), precision, активен ли на витрине, активен ли в БО, активен ли в Forex. Виджеты читают флаги, а не хардкод списков в шаблонах. Когда маркетинг просит «уберите экзотику с лендинга, но оставьте в терминале», вы меняете флаги, а не три копипасты.

Версионируйте изменения словаря. После добавления пары пробегите чеклист: REST снапшот, history, WS subscribe, карточка, тикер, терминал. Половина инцидентов «новый актив не работает» — это пара, добавленная только в админку БО.

Для акций и FX учитывайте сессии в статусе инструмента. Крипта 24/7 провоцирует привычку «всегда live»; на EURUSD ночью статус market closed должен быть явным, иначе тикеты про «зависший стакан» забьют очередь.

Релизный процесс ленты

Изменения нормализатора котировок катайте отдельно от релиза лендинга. Сначала staging терминал, потом прод виджеты. Держите feature flag на новый WS endpoint. Откат словаря символов должен быть столь же быстрым, как выкладка: сохраняйте предыдущий JSON. Связка с TradingView проверяется на каждой выкладке datafeed хотя бы одним символом BTC или EURUSD.

Критерий сдачи ленты: словарь, REST, WS, stale-алерт, whitelist доменов, учебная сделка на потребителе. Это фундамент для БО и Forex.

Сопровождение ленты

Владелец метрики stale назначается поименно. Раз в неделю — просмотр ошибок апстрима и доли пустых ответов. После инцидента обновляйте whitelist и runbook, не только «починили и забыли». Лента — общий ресурс витрины и брокера; изменения согласуйте с обеими командами, даже если это один человек.

Храните контакт эскалации провайдера ленты и номер тикета последнего инцидента в runbook — мелочь, которая экономит час ночью.