Документация

Risk Engine и справочник Webhook

Как AlgoVesta проверяет каждый сигнал перед исполнением и точное JSON-тело для отправки из TradingView или любого webhook-источника. Имена полей буквальные — копируйте как есть.

AlgoVesta исполняет сделки из трёх триггерных каналов: MCP-сервер для ИИ-ассистентов, сигналы Telegram и вебхуки TradingView. Какой бы канал ни сработал, один и тот же риск-движок на стороне сервера проверяет ордер перед тем, как он попадёт на вашу биржу или счёт MetaTrader 5. Эта страница — технический справочный центр для всех трёх каналов.

Три способа инициировать сделку

Каждый канал завершается одним и тем же путём исполнения: проверка, расчёт размера позиции, ордер, затем размещение стоп-лосса и тейк-профита непосредственно на бирже. Выберите канал, который соответствует тому, как вы уже работаете.

MCP-сервер для ИИ-ассистентов

Подключите Claude, ChatGPT, Cursor или любой другой MCP-совместимый клиент к двадцати нативным торговым инструментам через одну аутентифицированную ссылку. Каждое подключение начинается с paper-баланса $5 000, а ключи для реальной торговли создаются отдельно, со вторым фактором. Аутентификация выполняется либо через OAuth 2.1 с PKCE (S256), либо через персональную секретную ссылку.

Справочник разработчика MCP Подключить ИИ-ассистента

Каналы сигналов Telegram

Направьте AlgoVesta на каналы сигналов, за которыми вы уже следите. Сообщения разбираются на символ, направление, точку входа, стоп-лосс и цели, затем исполняются на вашей бирже или передаются в MetaTrader 5. Сигналы, которые нельзя однозначно разобрать, отклоняются, а не угадываются.

Telegram в MetaTrader 5 Подключить канал Telegram

Вебхуки TradingView

Отправляйте алерт от любого индикатора, рисунка или Pine-стратегии на ваш личный webhook URL. Тело алерта должно быть корректным JSON в формате, описанном ниже, а источник каждого автоматически исполняемого сигнала проверяется до открытия ордера.

Автоматизация TradingView Справочник payload

Risk Engine: как проверяется сигнал

Сигнал никогда не исполняется вслепую. Перед размещением ордера он проходит многомодульный слой верификации, который сверяет его с реальными рыночными условиями и заданными вами лимитами. Если жёсткое правило не проходит, сигнал отклоняется — а не уменьшается.

Нейронный скоринг — оценка уверенности 0–100 от модели скоринга.

Объём и поток ордеров — всплески объёма и дисбаланс агрессивных сделок (VPIN).

Рыночный режим — классификация тренд / диапазон / возврат к среднему.

Funding и ликвидации — динамика ставки funding и кластеры ликвидаций.

Карта стоп-лоссов — избегает размещения стопов внутри известных кластеров ликвидности.

Ваши жёсткие правила — направление, часы сессии, лимиты позиции и просадки.

Точный набор модулей и пороги меняются по мере настройки платформы. Принцип неизменен: ваши правила и лимиты риска всегда применяются до того, как ордер достигнет биржи.

Дневной убыток и защита от просадки

Помимо проверок по каждому сигналу, непрерывно работают две защиты на уровне счёта.

Лимит дневного убытка — Когда ваш реализованный убыток за день достигает заданного лимита — процент от баланса или фиксированная сумма — AlgoVesta переходит в Безопасный режим и прекращает открывать новые сделки до следующего дня.

Размер по просадке — По мере роста просадки счёта размер позиции автоматически уменьшается ступенями (осторожно → оборонительно → выживание), так что серия убытков снижает вашу экспозицию, а не наращивает её.

Справочник тела webhook

Отправьте HTTP POST с JSON-телом на ваш webhook-URL AlgoVesta. В TradingView вставьте это в поле сообщения алерта. Имена полей должны точно совпадать.

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }

Поле	Обязательно	Описание
`symbol`	Да	Торговая пара биржи, напр. BTCUSDT.
`side` / `action`	Да	Направление ордера: buy или sell.
`price`	Опционально	Референсная цена входа; опустите для входа по рынку.
`stop_loss`	Опционально	Цена стоп-лосса. Рекомендуется для каждого сигнала.
`take_profit`	Опционально	Цена тейк-профита. Несколько целей настраиваются в приложении.
`market`	Опционально	Целевой рынок: `crypto` (по умолчанию) или `forex`. Отправляется в MetaTrader 5, если установлено значение forex. Никогда не определяется по символу.
`lots`	Опционально	Только для форекс — размер позиции в лотах. Не указывайте это поле, чтобы использовать настроенный режим лота/риска.
`leverage`	Опционально	Только крипто — действует лимит вашей биржи для этого символа.
`amount_usd`	Опционально	Только для крипто — маржа, а не номинал. Номинал = маржа × плечо.
`risk_percent`	Опционально	Только для крипто — % от баланса, которым вы рискуете (0,1–50).
`quantity`	Опционально	Только для крипто — точное количество контрактов. `qty`, `size` и `contracts` принимаются как псевдонимы.
`take_profits`	Опционально	Несколько целей: `[{"price":…, "close_pct":…}]`. `tp1`…`tp5` с `tpN_close` также работают.
`trailing`	Опционально	`{"trigger_pct":…, "distance_pct":…}` — трейлинг-стоп.
`breakeven`	Опционально	`true` или `{"trigger_pct":…}` — переместить стоп на уровень входа при выходе в прибыль.

Префиксы биржи удаляются, поэтому BINANCE:BTCUSDT работает так же, как BTCUSDT. Для поля направления direction и type принимаются как псевдонимы action, а close является допустимым значением.

Размер позиции, плечо и риск на сигнал могут задаваться в вашей панели или в теле запроса — значение из тела запроса имеет приоритет. Именно поэтому URL вебхука является секретом: добавьте белый список IP, чтобы AlgoVesta автоматически исполняла только те сигналы, источник которых можно проверить.

Закрытие позиции

Отправьте "action": "close" с указанием символа. Закрывается вся позиция по этому символу — частичное закрытие не поддерживается; если вы запросите его, будет закрыта вся позиция, и панель сообщит об этом.

{ "symbol": "BTCUSDT", "action": "close" }

Оповещения стратегии Pine — выходы происходят автоматически

Если вы создаёте оповещение на основе Pine strategy() с параметром «Order fills only», не отправляйте только action: {{strategy.order.action}} возвращает sell и при выходе, что откроет короткую позицию вместо закрытия. Включите поля состояния позиции, и AlgoVesta сама определит вход, выход и разворот.

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }

Позиция после исполнения	Что делает AlgoVesta
`flat` (or `position_size` = 0)	Закрывает позицию. Обратный ордер не открывается.
Противоположно предыдущему состоянию	Разворот — сначала закрывается позиция, затем открывается в новом направлении. Если закрытие не удалось, ничего не открывается.
То же направление, что и раньше	Рассматривается как вход в этом направлении.

Сообщение должно быть в формате JSON. TradingView отправляет тело оповещения как обычный текст, если это не корректный JSON — сообщение по умолчанию (например, «BTCUSDT Crossing 1.00») не содержит направления и отклоняется. Мы никогда не угадываем по неоднозначному тексту; отклонить сигнал безопаснее, чем открыть ордер в неверном направлении. Также обратите внимание, что TradingView автоматически останавливает оповещения после 15 срабатываний за 3 минуты.

Без кода

Не пишите JSON вручную — создайте его визуально

Задайте направление, тейк-профит / стоп-лосс (один или несколько уровней), плечо, размер позиции, трейлинг и безубыток простыми переключателями. AlgoVesta сформирует точное сообщение алерта TradingView — скопируйте и вставьте в свой алерт.

Посмотреть, как работает визуальный конструктор → Пошаговая настройка алерта →

Часто задаваемые вопросы

Какие каналы могут инициировать сделку на AlgoVesta?

Три: MCP-сервер для ИИ-ассистентов, каналы сигналов Telegram и вебхуки TradingView. Сделку также можно открыть вручную из панели управления. Каждый канал проходит один и тот же путь исполнения и одни и те же проверки риска.

Обязателен ли формат JSON для вебхука TradingView?

Да. TradingView отправляет тело алерта как обычный текст, если оно не является корректным JSON, а сообщение алерта по умолчанию не содержит направления сделки — поэтому оно отклоняется. Используйте формат payload, описанный в разделе справочника payload вебхука выше, либо соберите его визуально и вставьте результат в свой алерт.

Применяется ли риск-движок также к ордерам через MCP и Telegram?

Да — на каждом канале выполняются одни и те же проверки на стороне сервера. Ваша политика риска, требование обязательного стоп-лосса, а также лимиты по позициям и просадке применяются до того, как ордер попадёт на биржу — независимо от того, пришёл ли он от ИИ-ассистента, сигнала Telegram или алерта TradingView. Ни один промпт или сообщение не может их ослабить.

Где найти полный справочник инструментов MCP?

Справочник разработчика MCP описывает все 20 инструментов, три области доступа (scope), аутентификацию через OAuth 2.1 и секретную ссылку, лимиты запросов, коды ошибок и 16 поддерживаемых бирж плюс MetaTrader 5.

Можно ли тестировать без реальных денег?

Да. Каждое MCP-подключение начинается с виртуального paper-баланса $5 000 по реальным рыночным ценам, а автоматизация TradingView и Telegram имеет демо-режим, который имитирует весь процесс от сигнала до ордера. Для реальной торговли всегда требуется отдельный, явно созданный ключ или подключение.