Как работает Barfinex
Inspector — политики риска и настройка
Как Inspector классифицирует позиции, применяет правила риска и какие основные опции конфигурации управляют его поведением.
Владение позициями
Inspector относит каждую позицию к одному из двух типов:
| Тип | Значение | Поведение Inspector |
|---|---|---|
| Legacy | Позиция существовала до старта текущей сессии Inspector | Только уведомления — без авто-закрытия и без изменения стопов. Оповещения (например в Telegram) при появлении факторов риска. |
| Runtime-managed | Позиция открыта во время работы Inspector | Полный контроль — выставление стопов, трейлинг, закрытие через API Provider при нарушении правил. |
Так существующие позиции не закрываются автоматически, а за позиции, «увиденные» Inspector с момента открытия, он отвечает полностью.
Что Inspector делает с runtime-позициями
- Защитные ордера — Выставляет стоп-лосс (STOP_MARKET) и тейк-профит (TAKE_PROFIT_MARKET) через Provider
POST /api/orders. Источник — Inspector. - Проверки риска — Оценка срабатывания стопа, макс. времени удержания, экспозиции портфеля. Может закрыть позицию противоположным рыночным ордером при нарушении правила.
- Трейлинг и безубыток — Опциональная логика трейлинг-стопа и безубытка по конфигу (процент трейлинга, процент безубытка).
- Учёт ликвидности — Может откладывать закрытие, если спред или глубина стакана выходят за заданные пределы (макс. спред для закрытия, мин. глубина).
Для Legacy позиций те же метрики риска считаются, но действие только уведомление; Inspector не закрывает и не меняет их автоматически.
Уведомления
Inspector может отправлять:
- Сводку при старте (например количество legacy-позиций)
- Оповещения о риске по legacy (только уведомление)
- События выставления стопов и успешного/неуспешного закрытия по runtime
- Предупреждения по ликвидности стакана (например при превышении допустимого спреда)
Канал уведомлений (например Telegram) настраивается в конфигурации Inspector или Provider. Для алертов детектора/Advisor см. Уведомления в Telegram; для Inspector может использоваться тот же или отдельный канал.
Основные области конфигурации
Поведение риска задаётся конфигом Inspector (например config.inspector.json). Типичные группы:
- riskManagement — Процент стоп-лосса, тейк-профита, безубытка, макс. сделок в день, макс. дневной убыток/прибыль %, макс. просадка %, макс. убыточных сделок в день, риск на сделку %, лимиты по коррелированным позициям.
- tradeSettings — Макс. время удержания позиции, макс. размер позиции %, процент трейлинг-стопа.
- assetManagement — Допустимый спред %, макс. спред для закрытия, мин. глубина для закрытия.
- strategyLogic — Стресс-политика, триггер спреда для стресса, макс. подряд убытков, авто-throttle детекторов (события риска, чтобы Detector мог приостановиться).
Точные имена полей и значения по умолчанию зависят от версии Barfinex; текущий конфиг в рантайме можно посмотреть через API Inspector GET /inspector/options (через прокси Provider).
Аудит и аналитика
- Живой аудит — Недавние события риска доступны через API Inspector (эндпоинт аудита риска). Удобно для дашбордов и отладки.
- QuestDB — При включении события риска могут записываться в хранилище временных рядов (например
inspector_risk_audit) для отчётности и анализа.
Дальше
- Обзор Inspector — Роль, источники данных, установка
- Справочник API Inspector — Эндпоинты опций, дашборда, аудита