Торговые вебхуки

Раздел Торговые вебхуки используется для подключения внешних торговых сигналов к фьючерсному рабочему процессу в Firedrake.

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

Зачем нужны вебхуки

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

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

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

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

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

• создать вебхук;
• отредактировать существующий вебхук;
• включить или отключить вебхук;
• искать и упорядочивать список вебхуков;
• копировать ссылки вебхука;
• использовать шаблоны сообщений для внешних систем;
• связывать вебхук с Настройками бота и Уведомлениями Telegram.

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

Базовая настройка вебхука

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

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

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

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

Ссылки вебхука

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

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

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

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

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

Хуки для конкретного символа

Обычный вебхук чаще всего создаётся для конкретного символа.

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

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

Универсальный вебхук

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

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

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

Шаблоны TradingView

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

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

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

• статические примеры;
• примеры динамической стратегии;
• шаблоны Open Long;
• шаблоны Close Long;
• шаблоны Open Short;
• шаблоны Close Short.

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

Закрытие по хуку

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

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

Когда Закрытие по хуку = ВЫКЛ

Если Закрытие по хуку установлено в положение ВЫКЛ, внешние сигналы на закрытие игнорируются и не используются для закрытия позиции.

В этом режиме предполагается, что позиция будет закрываться только по настройкам самого бота, например по его Тейк-профиту или Стоп-лоссу.

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

Когда Закрытие по хуку = ВКЛ

Если Закрытие по хуку установлено в положение ВКЛ, вебхук получает право участвовать в закрытии позиции.

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

• по настройкам бота, например по Тейк-профиту или Стоп-лоссу; либо
• по внешнему сигналу на закрытие, пришедшему через вебхук.

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

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

Режим Fire

Режим Fire — это продвинутая настройка, которая меняет то, как сигналы вебхука на закрытие применяются к позициям.

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

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

Как работают Закрытие по хуку и Режим Fire вместе

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

Сценарий 1: позиция открыта по вебхуку

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

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

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

Сценарий 2: позиция открыта не по вебхуку, Режим Fire = ВЫКЛ

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

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

Если позже приходит сигнал на закрытие по вебхуку, при этом Закрытие по хуку включено, но Режим Fire = ВЫКЛ, такая позиция не будет закрыта сигналом вебхука.

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

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

Сценарий 3: позиция открыта не по вебхуку, Режим Fire = ВКЛ

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

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

• Закрытие по хуку = ВКЛ
• Режим Fire = ВКЛ

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

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

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

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

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

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

Лимиты и время блокировки

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

Время блокировки

Время блокировки помогает защититься от слишком частых повторных сигналов за короткий промежуток времени. В форме вебхука это поле называется Блокировка (сек).

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

Макс. активных ботов

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

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

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

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

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

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

• начинать с вебхука с понятным названием;
• привязывать его к корректным Настройкам бота;
• сначала использовать консервативные лимиты;
• отдельно продумывать, должен ли Закрытие по хуку быть в положении ВЫКЛ или ВКЛ;
• включать Режим Fire только тогда, когда вы действительно хотите, чтобы сигнал вебхука на закрытие мог влиять и на позиции, открытые вне вебхука;
• внимательно работать с готовыми ссылками и шаблонами;
• тестировать цепочку алертов до реальной торговли;
• подключать Уведомления Telegram, если нужен дополнительный контроль вне платформы.

Как этот раздел связан с фьючерсным рабочим процессом

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

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

• Настройки бота определяют, как именно будет сопровождаться сделка после того, как вебхук-сигнал принят;
• Уведомления Telegram помогают следить за тем, что происходит после того, как вебхук начал влиять на счёт;
• Терминал показывает, к каким ботам, позициям и истории привели вебхук-сигналы;
• Дашборд позволяет позже оценить результат такой активности, вызванной вебхуками.

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

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

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

1. Создать вебхук и выбрать подходящую торговую конфигурацию.
2. Связать вебхук с нужными Настройками бота.
3. Настроить разумный Время блокировки и лимит по числу активных ботов.
4. Решить, должен ли вебхук только открывать сделки или также участвовать в закрытии.
5. Если требуется закрытие по внешнему сигналу, соответствующим образом настроить Закрытие по хуку.
6. Если внешний сигнал должен уметь закрывать и позиции, открытые вне вебхука, включить Режим Fire.
7. Открыть окно ссылок и скопировать правильную ссылку вебхука.
8. Если используется UNIVERSAL, выбрать подходящий шаблон TradingView.
9. Настроить алерт во внешней системе.
10. Аккуратно протестировать сценарий до реальной торговли.
11. Затем использовать Терминал и Дашборд для контроля результата.

Итог

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

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