Как работает Barfinex
API контекста сигналов — контекст стратегии и триггеры
Как Barfinex предоставляет HTF-контекст (свечи, bias, зоны) и данные order flow для стратегий и Advisor. GET /signals/context/:symbol и структура ответа.
Назначение
Barfinex поддерживает подход контекст + триггер для стратегий и Advisor:
- Свечи старших таймфреймов (HTF) (D1, H4, H1) дают контекст: режим, bias, уровни, зоны интереса.
- Внутридневной order flow и стакан дают тайминг входа: абсорбция, перекос стакана, sweep и reclaim, откат с подтверждением.
- Риск и выход могут определяться по HTF-зонам (например стоп за зоной, цель на середине или противоположной границе).
Платформа предоставляет это через API контекста сигналов и связанные потоки событий, чтобы детекторы и Advisor работали с единым представлением контекста и триггеров.
API Provider: GET /api/signals/context/:symbol
Эндпоинт возвращает нормализованный контекст по символу: свечи (D1/H4/H1), агрегаты order flow, агрегаты стакана и при необходимости контекстные признаки (bias, режим, уровни, зоны).
Query-параметры
| Параметр | Описание | По умолчанию (типично) |
|---|---|---|
connectorType | Коннектор (например binance) | binance |
marketType | Рынок (spot, futures, margin) | futures |
daysD1 | Дней истории D1 | 365 |
daysH4 | Дней истории H4 | 180 |
daysH1 | Дней истории H1 | 90 |
candlesMode | FULL — вернуть массивы свечей; DELTA — не отдавать свечи при совпадении ключа | FULL |
candlesKey | Ключ кэша из предыдущего ответа; используется с candlesMode=DELTA, чтобы не дублировать неизменённые свечи | — |
Пример запроса (полный контекст)
curl "http://localhost:8080/api/signals/context/BTCUSDT?connectorType=binance&marketType=futures&daysD1=365&daysH4=180&daysH1=90"
Пример запроса (delta — без повторной отдачи свечей)
curl "http://localhost:8080/api/signals/context/BTCUSDT?connectorType=binance&marketType=futures&candlesMode=DELTA&candlesKey=<lastCandlesKey>"
Структура ответа (основное)
candles
- cacheKey — Ключ, который можно передать обратно как
candlesKeyв режиме delta. - h1, h4, d1 — Массивы свечей (time, open, high, low, close, volume). В режиме
DELTAпри совпадении ключа могут быть опущены или заменены только наcacheKey.
orderFlow (агрегаты)
Сводные признаки для триггеров (не тик-за-тиком): например delta ratio, CVD, absorption score, количество сделок, средний/макс размер сделки, объём покупок/продаж, delta, VWAP.
orderBook (агрегаты)
Лучший bid/ask, mid, спред, спред в %, дисбаланс, стены bid/ask (например в USD).
contextFeatures (опционально)
Компактный HTF-контекст, рассчитанный на стороне Provider: bias (LONG/SHORT/NEUTRAL), режим (range/trend), уровни (htfHigh, htfLow, htfMid) и зоны (HTF_LOW, HTF_HIGH с диапазоном и таймфреймом). Используется Advisor и детекторами как краткая сводка; полные свечи остаются основным источником при необходимости.
Как используют детекторы и Advisor
- Детекторы — Могут использовать контекст (bias, зоны) и логику триггеров (order flow, стакан) в пайплайне: например не торговать против HTF bias, вход только внутри зоны, риск/выход из HTF-диапазона.
- Advisor — Получает контекстные признаки и агрегаты (и при необходимости сводки по свечам) в payload решения; полные массивы свечей для LLM не обязательны, но доступны в пайплайне детектора/контекста.
Подробнее по API — в Справочнике API Provider. По архитектуре — в Архитектура Barfinex.