Перейти к основному содержимому

Trade Web-Hooks

Раздел Trade Web-Hooks используется для подключения внешних торговых сигналов к Futures workflow в Firedrake.

Открывайте этот раздел, если хотите получать сигналы из внешней системы, например из TradingView, а не полагаться только на ручной анализ внутри платформы.

Зачем нужны webhooks​

Используйте webhooks, когда у вас уже есть внешний источник сигналов и нужно, чтобы Firedrake реагировал на него в контролируемом формате.

Этот раздел нужен, когда вы хотите:

  • связать внешний сигнал с Futures-настройкой;
  • выбрать, на какой инструмент должен влиять сигнал;
  • задать правила обработки повторяющихся сигналов;
  • привязать сигнал к готовой торговой конфигурации, а не принимать решение вручную каждый раз;
  • определить, как внешние сигналы на закрытие должны работать вместе с собственной логикой закрытия бота.

Что пользователь делает в этом разделе​

В этом разделе можно:

  • создать webhook;
  • отредактировать существующий webhook;
  • включить или отключить webhook;
  • искать и упорядочивать список webhook'ов;
  • копировать webhook links;
  • использовать шаблоны сообщений для внешних систем;
  • связывать webhook с Bot Settings и Telegram Notifications.
Futures Trade Web-Hooks list

Раздел подходит и для первичной настройки, и для дальнейшего сопровождения.

Базовая настройка webhook​

Когда вы создаёте webhook, вы задаёте условия, по которым Firedrake должен обрабатывать входящий сигнал.

Такая настройка может включать:

  • инструмент или symbol;
  • связанные Bot Settings;
  • Lock time;
  • максимальное число активных ботов для этого webhook;
  • разрешение или запрет на участие webhook в закрытии позиции.

Webhook задаёт источник сигнала и правила применения этого сигнала в наборе торговых настроек.

У каждого webhook есть готовые ссылки, которые можно использовать во внешней системе.

Они позволяют взять уже подготовленный Firedrake webhook и подключить его снаружи без ручной сборки всей логики.

WebHook links popup

Обычно сюда заходят, чтобы:

  • открыть окно со ссылками;
  • скопировать правильную ссылку для выбранного webhook;
  • вставить её во внешний источник сигнала;
  • не перепутать ссылки между разными настройками.

Для многих пользователей именно на этом шаге webhook становится готовым к использованию вне платформы.

Symbol-specific hooks​

Обычный webhook чаще всего создаётся для конкретного symbol.

Используйте такой формат, когда вы заранее знаете, для какого инструмента должен работать сигнал. Это самый прямой и понятный вариант настройки, при котором webhook связан с конкретным инструментом и определённым набором торговых настроек.

Для пользователей, которым нужен более фиксированный и предсказуемый сценарий, symbol-specific hooks обычно являются самым простым вариантом.

Universal webhook​

Режим UNIVERSAL — более гибкий формат webhook.

Он подходит для пользователей, которые хотят отправлять более общий внешний сигнал и указывать уже в самом сообщении, идёт ли речь об открытии или закрытии позиции, а также о long или short сценарии.

UNIVERSAL подходит для более сложных alert-сценариев, где один общий формат должен поддерживать несколько вариантов поведения сигнала.

TradingView templates​

Одна из практических частей UNIVERSAL webhook — встроенные шаблоны сообщений для TradingView alerts.

Universal webhook TradingView templates

Эти шаблоны помогают быстро подготовить TradingView alert и не собирать всё сообщение вручную каждый раз.

В зависимости от сценария здесь могут использоваться шаблоны вроде:

  • static examples;
  • dynamic strategy examples;
  • open long templates;
  • close long templates;
  • open short templates;
  • close short templates.

Это уменьшает объём ручной работы и снижает вероятность ошибок при подключении TradingView к Firedrake.

Close By Hook​

Close By Hook определяет, может ли внешний сигнал на закрытие закрывать позицию через данный webhook.

Используйте эту настройку, чтобы определить, как сигналы на закрытие из TradingView или другой внешней системы работают вместе с правилами закрытия бота.

Когда Close By Hook = Off​

Если Close By Hook установлен в положение Off, внешние сигналы на закрытие игнорируются и не используются для закрытия позиции.

В этом режиме предполагается, что позиция будет закрываться только по настройкам самого бота, например по его Take Profit или Stop Loss.

Используйте этот режим, если webhook должен отвечать только за вход, а закрытие должно оставаться под контролем правил самого бота.

Когда Close By Hook = On​

Если Close By Hook установлен в положение On, webhook получает право участвовать в закрытии позиции.

В этом случае позиция может закрыться либо:

  • по настройкам бота, например по Take Profit или Stop Loss; либо
  • по внешнему сигналу на закрытие, пришедшему через webhook.

Сделку закроет то корректное условие, которое сработает раньше.

Используйте этот режим, если внешняя система должна участвовать во входе и выходе.

FireMode​

FireMode — это продвинутая настройка, которая меняет то, как сигналы webhook на закрытие применяются к позициям.

Если FireMode не используется, логика закрытия через webhook остаётся привязанной к позициям, которые изначально были открыты именно этим webhook.

Если FireMode включён, webhook можно использовать и в более широких сценариях закрытия.

Как работают Close By Hook и FireMode вместе​

Проще всего понять эти настройки на практических сценариях.

Сценарий 1: позиция открыта по webhook​

Предположим, позиция была открыта по webhook.

Если позже по этому webhook приходит сигнал на закрытие, и закрытие через webhook разрешено, позиция может быть закрыта этим внешним сигналом.

Это стандартный сценарий: webhook участвует во входе и затем при необходимости участвует в закрытии.

Сценарий 2: позиция открыта не по webhook, FireMode = Off​

Предположим, позиция была открыта не по webhook.

Например, она могла быть открыта ботом Firedrake или вручную из Terminal screener.

Если позже приходит сигнал на закрытие по webhook, при этом Close By Hook включён, но FireMode = Off, такая позиция не будет закрыта сигналом webhook.

В этом случае сигнал игнорируется, потому что данная позиция изначально не была открыта через этот webhook.

Так webhook сохраняет строгие и изолированные правила закрытия.

Сценарий 3: позиция открыта не по webhook, FireMode = On​

Предположим, позиция была открыта ботом Firedrake или вручную из Terminal screener, а не самим webhook.

Если вы всё равно хотите, чтобы внешний сигнал мог закрыть такую позицию, webhook нужно настроить так:

  • Close By Hook = On
  • FireMode = On

В этом режиме сигнал на закрытие, пришедший через webhook, сможет закрыть позицию, даже если она была изначально открыта вне webhook.

Используйте этот режим, если внешняя система, например TradingView, должна выступать дополнительным механизмом выхода для позиций, открытых другими частями платформы.

Типовые сценарии​

Эти настройки определяют, как разные источники сигналов работают вместе.

Они поддерживают несколько распространённых сценариев:

  • консервативный, где webhook открывает сделки, а закрытие происходит только по настройкам бота;
  • смешанный, где сделка может закрыться и по логике бота, и по внешнему сигналу;
  • продвинутый, где внешний сигнал на закрытие может закрывать даже те позиции, которые были открыты вне webhook.

Limits and lock time​

Этот раздел также помогает контролировать, насколько часто webhook может срабатывать.

Lock time​

Lock time помогает защититься от слишком частых повторных сигналов за короткий промежуток времени.

Используйте эту настройку, чтобы избежать повторного запуска одной и той же логики слишком быстро подряд.

Max active bots​

Max active bots помогает ограничить количество bot-driven действий, которые могут одновременно работать для этого webhook.

Используйте эту настройку, чтобы ограничить рост числа одновременных позиций из одного webhook.

Вместе эти настройки помогают сделать работу webhook более безопасной и предсказуемой.

Рекомендации по безопасной настройке​

Trade Web-Hooks — один из самых чувствительных разделов Futures-модуля, потому что webhook может приводить к реальной торговой активности.

Поэтому безопаснее всего действовать так:

  • начинать с webhook с понятным названием;
  • привязывать его к корректным Bot Settings;
  • сначала использовать консервативные limits;
  • отдельно продумывать, должен ли Close By Hook быть в положении Off или On;
  • включать FireMode только тогда, когда вы действительно хотите, чтобы сигнал webhook на закрытие мог влиять и на позиции, открытые вне webhook;
  • внимательно работать с готовыми ссылками и шаблонами;
  • тестировать alert flow до реальной торговли;
  • подключать Telegram Notifications, если нужен дополнительный контроль вне платформы.

Как этот раздел связан с Futures workflow​

Trade Web-Hooks — это часть Futures-процесса, а не отдельный блок автоматизации.

Связанные разделы:

  • Bot Settings определяют, как именно будет сопровождаться сделка после того, как webhook-сигнал принят;
  • Telegram Notifications помогают следить за тем, что происходит после того, как webhook начал влиять на счёт;
  • Terminal показывает, к каким ботам, позициям и истории привели webhook-сигналы;
  • Dashboard позволяет позже оценить результат такой webhook-driven активности.

Этот раздел подключает внешние сигналы к остальным частям Futures-процесса.

Типичный сценарий работы​

Обычный пользовательский сценарий выглядит так:

  1. Создать webhook и выбрать подходящую торговую конфигурацию.
  2. Связать webhook с нужными Bot Settings.
  3. Настроить разумный Lock time и лимит по числу активных ботов.
  4. Решить, должен ли webhook только открывать сделки или также участвовать в закрытии.
  5. Если требуется закрытие по внешнему сигналу, соответствующим образом настроить Close By Hook.
  6. Если внешний сигнал должен уметь закрывать и позиции, открытые вне webhook, включить FireMode.
  7. Открыть окно ссылок и скопировать правильный webhook link.
  8. Если используется UNIVERSAL, выбрать подходящий TradingView template.
  9. Настроить alert во внешней системе.
  10. Аккуратно протестировать сценарий до реальной торговли.
  11. Затем использовать Terminal и Dashboard для контроля результата.

Summary​

Используйте Trade Web-Hooks, если хотите, чтобы внешние сигналы стали частью Futures-процесса в понятном и контролируемом виде.

Этот раздел позволяет связать внешнюю сигнальную систему с execution settings, limits и bot rules в Firedrake, включая более гибкое управление входами и закрытиями.