Справочник API Advisor

REST API Barfinex Advisor: health, метрики, открытые сигналы, блокировки, история setup, промпты, контекст цены, решение LLM, аудит, рекомендации, новости и финансовые данные.

Обзор

Advisor предоставляет REST API для health, метрик, открытых сигналов, блокировок по символам, истории setup, активного промпта, цены из контекста, запроса решения LLM, аудита, а также для финансовых рекомендаций, новостей и портфеля.

Базовый URL при вызове через Provider: GET|POST /api/advisors/:appKey/... (например appKey = advisor)
Прямой базовый URL: {advisorUrl}/api (порт по умолчанию 8009)

Все пути ниже — относительно /api. При использовании прокси Provider префикс пути задаётся в документации Provider (матрица proxy); обычно для агента это /api/advisors/:appKey/advisor-agent/....

REST-эндпоинты (сводка)

Advisor Agent (сигнальный агент)

Метод	Путь	Описание
GET	`/advisor-agent/health`	Health и состояние оркестратора
GET	`/advisor-agent/metrics`	Метрики: оркестратор, открытые сигналы, блокировки
GET	`/advisor-agent/signals/open`	Открытые сигналы в памяти (query: `limit`)
GET	`/advisor-agent/locks`	Активные блокировки по символам
GET	`/advisor-agent/setup/history`	История setup-памяти (query: `symbol`, `limit`)
GET	`/advisor-agent/prompt/active`	Активная промпт-политика
GET	`/advisor-agent/prompt/history`	История промптов
GET	`/advisor-agent/context/price`	Последняя цена из контекста (query: `symbol`)
GET	`/advisor-agent/audit/questdb`	Аудит QuestDB (query: `table`, `limit`)
GET	`/advisor-agent/llm/decision`	Запрос решения LLM по символу (query: `symbol`)
POST	`/advisor-agent/orchestrator/run-once`	Один цикл оркестратора вручную

Финансовые рекомендации

Метод	Путь	Описание
POST	`/financial-recommendations/trading-advice`	Торговый совет (body: `instrument`)
POST	`/financial-recommendations/portfolio-optimization`	Оптимизация портфеля (body: `portfolio`)
POST	`/financial-recommendations/scenario-analysis`	Анализ сценария (body: `scenario`)

Новости и финансовые данные

Метод	Путь	Описание
GET	`/news/fetch`	Получить новости (query: `query`)
GET	`/news/sentiment`	Тональность новостей (query: `query`)
GET	`/financial-api/price`	Текущая цена (query: `instrument`)
GET	`/financial-api/historical`	Исторические данные (query: `instrument`)

Метод	Путь	Описание
GET	`/recommendations/signals`	Рекомендации по сигналам (query: `instrument`)
GET	`/recommendations/portfolio`	Рекомендации по портфелю (query: `userId`)

Через прокси Provider

Используйте пути из Справочника API Provider (матрица proxy). Примеры:

GET /api/advisors/:appKey/advisor-agent/health
GET /api/advisors/:appKey/advisor-agent/metrics
GET /api/advisors/:appKey/advisor-agent/signals/open
GET /api/advisors/:appKey/advisor-agent/context/price?symbol=BTCUSDT
GET /api/advisors/:appKey/advisor-agent/llm/decision?symbol=BTCUSDT
POST /api/advisors/:appKey/advisor-agent/orchestrator/run-once
POST /api/advisors/:appKey/financial-recommendations/trading-advice
GET /api/advisors/:appKey/news/fetch, GET .../news/sentiment
GET /api/advisors/:appKey/recommendations/signals, GET .../recommendations/portfolio

События (для интеграторов)

Advisor подписывается на сигналы детектора и при необходимости на запросы решений на шине и публикует ответы с решением и снимки контекста. Для решений в реальном времени используйте WebSocket Provider (/ws) и подпишитесь на ADVISOR_DECISION_RESPONSE, ADVISOR_DECISION_CONTEXT_SNAPSHOT и связанные события. Подключаться к Advisor или шине напрямую не требуется.

Дальше

Обзор Advisor — Роль и настройка
Справочник API Provider — Прокси и WebSocket