Как создать сигнального бота на Freya Finance

#Как создать сигнального бота на Freya Finance

Сигнальный бот исполняет сделки, когда получает внешний сигнал — чаще всего это оповещение TradingView, отправленное на вебхук. Вместо того чтобы выстраивать логику входа внутри Freya (как это делает DCA-бот), вы приносите собственные сигналы с другой платформы, а сигнальный бот превращает их в реальные сделки на вашей бирже.

Если у вас уже есть стратегия или связка индикаторов, которым вы доверяете, сигнальный бот — это способ автоматизировать их на Freya. (Если вы предпочитаете строить логику внутри Freya, начните с руководства Как создать вашего первого DCA-бота.)

---

#Что такое сигнальный бот

В DCA-боте условия входа настраиваются внутри Freya. Сигнальный бот устроен наоборот: решение о том, когда входить или выходить, приходит извне — от вашей графической платформы, вашего собственного скрипта или любого инструмента, способного отправить вебхук. Когда сигнал приходит, сигнальный бот размещает сделку. Это мост между вашей внешней стратегией и живым исполнением на вашей бирже.

#Краткий обзор шагов

1. Создайте бота и выберите тип Сигнальный бот, затем укажите торговую пару и направление.
2. Выберите режим сигнала — «Пользовательский сигнал» или Risk Ratio (где вебхук несёт ваши тейк-профит и стоп-лосс).
3. Скопируйте URL вебхука (или URL-адреса) — «Пользовательский сигнал» даёт URL открытия и URL закрытия; Risk Ratio даёт единственный URL.
4. Подключите источник сигналов — вставьте эти URL-адреса в оповещение TradingView (или другой инструмент).
5. Задайте настройки ордеров и запустите бота. С этого момента вашими сигналами управляет бот.

#Шаг 1: Выберите тип «Сигнальный бот»

В процессе создания бота выберите Сигнальный бот («Исполнение сделок по сигналам вебхуков»), затем укажите торговую пару и направление — так же, как и для любого другого бота.

#Шаг 2: Выберите режим сигнала

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

• Пользовательский сигнал — бот действует по сигналам открытия и закрытия, которые вы отправляете через вебхук (например, из оповещения TradingView), а ордера в Freya настраиваете вы: сумму сделки, а также тейк-профит и стоп-лосс.
• Risk Ratio — полезная нагрузка вебхука несёт цены тейк-профита и стоп-лосса; вход берётся по рыночной цене в момент срабатывания сигнала. Вместо выбора суммы сделки вы задаёте фиксированную сумму риска на сделку, и Freya автоматически рассчитывает размер позиции исходя из расстояния между входом и стоп-лоссом. Результат: если стоп-лосс сработает, вы потеряете примерно ровно ту сумму риска, которую выбрали. Тейк-профит размещается лимитным ордером по цене из вебхука (то есть исполняется без проскальзывания); стоп-лосс при срабатывании исполняется рыночным ордером, поэтому — как и любой стоп — на быстром движении он может столкнуться с проскальзыванием.

Выберите режим, который соответствует тому, как построены ваши сигналы.

#Почему режим Risk Ratio так силён

Режим Risk Ratio переворачивает расчёт размера позиции с ног на голову. Обычно вы выбираете размер позиции и миритесь с тем убытком, который подразумевает стоп-лосс. В режиме Risk Ratio вы выбираете убыток, который готовы принять, а размер позиции подбирается под него автоматически. Благодаря этому ваш риск на сделку остаётся постоянным независимо от того, насколько далеко стоит стоп-лосс, — дисциплинированный подход, которым пользуются профессионалы. Тип риска и фиксированную сумму вы задаёте на шаге стратегии; сумма сделки после этого отображается как динамическая, потому что она вычисляется в момент прихода вебхука.

#Шаг 3: Получите URL-адреса вебхуков

Какие URL-адреса вы получите, зависит от режима:

• В режиме Пользовательский сигнал боту выдаются URL вебхука открытия (вызов открывает позицию) и отдельный URL вебхука закрытия (вызов закрывает позицию).
• В режиме Risk Ratio вы получаете единственный URL вебхука для сигнала входа. Позиция затем закрывается автоматически по тейк-профиту и стоп-лоссу, которые несёт вебхук, поэтому отдельного URL закрытия нет. Сигнал отправляется небольшим JSON-сообщением, включающим значения тейк-профита и стоп-лосса.

URL можно скопировать и перегенерировать в любой момент. Перегенерация создаёт новый URL и немедленно делает старый недействительным — это полезно, если URL когда-либо был раскрыт.

#Шаг 4: Подключите источник сигналов

Вставьте URL вебхука (или URL-адреса) в ваш источник сигналов. В TradingView, например, вы создаёте оповещение и указываете в качестве его webhook URL адрес вашего бота. В режиме Пользовательский сигнал вы используете URL открытия для входов и URL закрытия для выходов; в режиме Risk Ratio вы используете единственный вебхук и включаете тейк-профит и стоп-лосс в текст оповещения. Когда условие вашего оповещения сработает, TradingView вызовет вебхук, и бот отработает сигнал.

#Шаг 5: Задайте настройки ордеров

Настройте, как бот рассчитывает размер и размещает ордера. В режиме Пользовательский сигнал вы задаёте сумму сделки, а также тейк-профит и стоп-лосс. В режиме Risk Ratio вы вместо этого задаёте фиксированную сумму риска (сумма сделки становится динамической, а тейк-профит и стоп-лосс приходят из вебхука). Затем запустите бота — он будет тихо ждать, пока не придёт сигнал, и тогда исполнит сделку.

#Как обезопасить ваши вебхуки

Это самая важная привычка при работе с сигнальными ботами: URL-адреса ваших вебхуков — это секреты. Любой, у кого есть URL, может запустить соответствующее действие на вашем боте, поэтому:

• Никогда не публикуйте URL-адреса вебхуков и не делитесь ими.
• Вставляйте их только в доверенные инструменты — например, в ваши собственные оповещения TradingView.
• Немедленно перегенерируйте URL, если подозреваете, что он был раскрыт: старый перестаёт работать сразу же.

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

#Что такое сигнальный бот на Freya Finance?

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

#Как подключить TradingView к сигнальному боту?

Выберите режим Пользовательский сигнал, скопируйте URL-адреса вебхуков открытия и закрытия вашего бота и вставьте их в ваши оповещения TradingView (URL открытия — для входов, URL закрытия — для выходов). В режиме Risk Ratio вы вместо этого используете единственный URL вебхука и включаете тейк-профит и стоп-лосс в текст оповещения. Когда оповещение сработает, TradingView вызовет вебхук, и бот совершит сделку.

#В чём разница между режимом «Пользовательский сигнал» и режимом Risk Ratio?

В режиме «Пользовательский сигнал» бот действует по сигналам открытия и закрытия, которые вы отправляете через вебхук, а ордера вы настраиваете сами — сумму сделки, а также тейк-профит и стоп-лосс. В режиме Risk Ratio полезная нагрузка вебхука несёт цены тейк-профита и стоп-лосса (вход берётся по рынку в момент срабатывания сигнала), и вместо суммы сделки вы задаёте фиксированную сумму риска — Freya затем автоматически подбирает размер позиции исходя из расстояния от входа до стоп-лосса, так что стоп-аут обойдётся вам примерно ровно в тот риск, который вы выбрали. Комбинировать режимы нельзя; выберите тот, который соответствует тому, как построены ваши сигналы.

#Как работает расчёт размера позиции в режиме Risk Ratio?

Вы задаёте фиксированную сумму риска на сделку. Когда сигнал срабатывает, Freya берёт вход по рыночной цене и считывает стоп-лосс из вебхука, а затем рассчитывает размер позиции так, чтобы убыток на стоп-лоссе был равен выбранному вами риску. Это удерживает ваш риск на сделку постоянным независимо от того, насколько широкий или узкий стоп, — вы решаете, какой убыток готовы принять, а размер подстраивается сам.

#Являются ли URL-адреса моих вебхуков секретными?

Да — относитесь к ним как к паролям. Любой, у кого есть URL вебхука, может запустить соответствующее действие на вашем боте. Никогда ими не делитесь, вставляйте их только в доверенные инструменты и немедленно перегенерируйте URL, если считаете, что он был раскрыт. Перегенерация делает старый URL недействительным сразу же.

#Я отправил сигнал, но ничего не произошло — почему?

Проверьте, что вы использовали правильный URL вебхука (открытия или закрытия), что режим сигнала соответствует тому, как настроено ваше оповещение, и что бот запущен, а не поставлен на паузу. Если вы недавно перегенерировали URL, убедитесь, что источник сигналов использует новый. Об общем состоянии бота читайте в статье Почему мой бот не торгует?.

#Может ли вебхук задавать мой тейк-профит и стоп-лосс?

Да, если вы используете режим Risk Ratio. В этом режиме значения тейк-профита и стоп-лосса приходят из полезной нагрузки вебхука, а не вводятся вручную в Freya, что позволяет вашей внешней стратегии управлять выходами.