Бот для TradingView: как подключить алерты к бирже через вебхук

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

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

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

Как работают алерты и вебхуки TradingView

Конвейер состоит из трёх частей.

Алерт это условие, которое вы задаёте на графике TradingView: пересечение ценой уровня, разворот индикатора, срабатывание пользовательского скрипта. Сам по себе он может появиться на экране, прислать вам письмо или push-уведомление на телефон, но во всех этих случаях действовать всё равно должны вы.

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

Бот это принимающая сторона. Сигнальный бот Freya предоставляет приватный URL вебхука; когда сообщение приходит, бот выполняет настроенное для него действие на подключённом биржевом счёте.

Полная цепочка:

1. Условие на вашем графике в TradingView становится истинным
2. Срабатывает алерт, и TradingView обращается к URL вебхука вашего бота
3. Freya получает сигнал, и ваш бот размещает ордер на вашей бирже
4. Затем бот управляет позицией согласно своим настройкам

Ключевая модель: ваша стратегия живёт в TradingView, а Freya это слой исполнения. Вся логика тайминга находится внутри вашего алерта.

Что делает вебхук-триггер Freya

В Freya исполнение вебхуков берёт на себя сигнальный бот: тип бота, описанный в мастере создания как «Совершать сделки на основе сигналов вебхуков». В отличие от триггера на основе индикатора (RSI, EMA и так далее), у вебхук-триггера нет таймфрейма и нет условия, настраиваемого внутри Freya. Решение о том, когда срабатывать, полностью принадлежит вашему алерту TradingView. Задача Freya это то, что происходит дальше.

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

• TradingView Webhook (режим пользовательского сигнала). Бот получает два URL: URL открывающего вебхука и URL закрывающего вебхука. Сообщение на открывающий URL открывает позицию, используя настройки ордера, заданные вами в Freya: сумму сделки, тейк-профит и стоп-лосс. Сообщение на закрывающий URL закрывает её.

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

Пошагово: подключение TradingView к боту

Шаг 1: создайте сигнального бота

В мастере создания бота Freya выберите тип Сигнальный бот, затем укажите биржевой счёт, торговую пару и направление, как и для любого другого бота. Полное пошаговое руководство Как создать сигнального бота на Freya Finance подробно разбирает каждый экран.

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

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

Шаг 3: скопируйте URL вебхука(ов)

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

Шаг 4: создайте алерт в TradingView

На графике TradingView создайте алерт с условием, которое соответствует вашему входу. В настройках уведомлений алерта включите опцию Webhook URL и вставьте URL вашего бота: открывающий URL в режиме пользовательского сигнала или единственный URL в режиме Risk Ratio. Для выходов по алерту в режиме пользовательского сигнала создайте второй алерт для условия выхода и направьте его на закрывающий URL.

Шаг 5: задайте сообщение алерта

Сообщение алерта это payload, который TradingView доставляет вашему боту. Используйте ровно тот формат, который показывает экран настройки бота: в режиме Risk Ratio Freya показывает Шаблон JSON Body с кнопкой копирования в один клик; ваш алерт должен отправлять эту структуру с подставленными значениями тейк-профита и стоп-лосса. Не импровизируйте: если сообщение не совпадает с тем, что ожидает бот, сигнал игнорируется, а не додумывается.

Шаг 6: протестируйте до запуска на реальном рынке

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

1. Задайте условие алерта, которое, как вы знаете, сработает быстро (пересечение ценой уровня, которого она вот-вот коснётся)
2. Дайте ему сработать, затем проверьте журнал активности бота на наличие события входящего сигнала
3. Убедитесь, что позиция открылась на бирже с ожидаемым размером
4. Запустите закрытие (сигнал на закрывающий URL или тейк-профит/стоп-лосс в режиме Risk Ratio) и убедитесь, что позиция действительно закрылась

Только после чистого полного цикла подключайте свою настоящую стратегию и реальный размер.

Рабочий пример: расчёт размера в режиме Risk Ratio

Предположим, вы задали фиксированный риск $20 на сделку, привязанный к стоп-лоссу. Ваш алерт TradingView срабатывает при цене BTC $100,000, а в сообщении несёт стоп-лосс $98,000 и тейк-профит $104,000.

• Вход: по рынку, исполнен по $100,000
• Расстояние до стоп-лосса: $2,000 на BTC (2%)
• Размер позиции: риск $20 ÷ $2,000 на BTC = 0.01 BTC (около $1,000 экспозиции)
• Тейк-профит: лимитный ордер по $104,000; если он исполнится, прибыль составит 0.01 × $4,000 = $40, соотношение 2:1 к риску в $20
• Стоп-лосс: рыночный ордер при срабатывании $98,000; примерно те $20, что вы выбрали, плюс комиссии, и, возможно, чуть больше при резком движении, потому что сработавший стоп исполняется по рынку

Находится ли ваш стоп в 1% или 5% от входа, сумма под риском остаётся $20, потому что размер позиции подстраивается. Именно в этом постоянстве и заключается весь смысл режима Risk Ratio.

Надёжность: на что можно и на что нельзя рассчитывать

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

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

Задержки и сбои случаются. Маркетплейс Freya помечает стратегии на основе вебхуков предупреждением о внешнем сигнале: сделки запускаются сигналами TradingView или вебхука, и на стороне источника возможны задержки или перебои. Если у TradingView произошёл инцидент, ваш алерт не срабатывает, и бот, что правильно, не делает ничего. Freya исполняет то, что приходит; она не может исполнить то, что так и не пришло.

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

Одноразовые алерты перестают срабатывать. Алерт TradingView, настроенный на срабатывание «Only Once», после одного сигнала завершается, пока вы не создадите его заново. Для повторяющейся стратегии выберите вариант повторяющегося триггера и проверьте дату окончания действия алерта.

Безопасность: ваш URL вебхука это секрет

URL вебхука это ключ к запуску вашего бота. Никакого пароля поверх него нет: обладание URL и есть учётные данные.

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

Устранение неполадок: алерт сработал, но сделки не было

Причина почти всегда из короткого списка. Пройдите его по порядку:

1. Бот запущен? Приостановленный или остановленный бот игнорирует входящие сигналы. Это самая частая причина.
2. Правильный URL в правильном слоте? Алерт входа, направленный на закрывающий URL, никогда не откроет позицию. Проверьте, что различаете открывающий и закрывающий URL, и что URL вставлен полностью.
3. Вы недавно перегенерировали URL? Перегенерация мгновенно аннулирует старый URL. Если в алерте остался старый, его сообщения уходят в никуда.
4. Совпадает ли формат сообщения? Особенно в режиме Risk Ratio сообщение должно соответствовать структуре JSON с экрана настройки бота. Некорректно сформированное сообщение игнорируется.
5. Может ли ваш план TradingView вообще отправлять вебхуки? Если нет, алерт срабатывает визуально, но сообщение не отправляется. Также проверьте, не истёк ли срок действия алерта и не был ли он настроен на «Only Once».
6. Биржевые минимумы. Если заданная вами сумма или автоматически рассчитанный размер в режиме Risk Ratio оказывается ниже минимального размера ордера для пары, биржа отклоняет ордер.

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

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

Нужен ли платный план TradingView для вебхук-ботов?

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

В чём разница между открывающим и закрывающим URL вебхука?

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

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

Да, именно для этого и существует режим Risk Ratio. В этом режиме сообщение алерта это небольшой JSON-payload с ценами тейк-профита и стоп-лосса, а экран настройки Freya предоставляет Шаблон JSON Body для копирования в ваш алерт. Когда сигнал приходит, вход берётся по рыночной цене, а выходы размещаются по значениям из вашего сигнала: тейк-профит лимитным ордером по точной цене, которую вы отправили, а стоп-лосс рыночным ордером при достижении его триггерной цены. Поскольку стоп исполняется по рынку, при резком движении он может дать проскальзывание, как и любой стоп-ордер. В режиме пользовательского сигнала вебхук не может задавать уровни выхода; тейк-профит и стоп-лосс берутся из настроек ордера, которые вы задаёте внутри Freya, а ваши алерты ограничены тем, чтобы сообщать, когда открывать и когда закрывать.

Безопасно ли вставлять мой URL вебхука в TradingView?

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

Почему мой алерт сработал, но сделки не произошло?

Начните с самого бота: приостановленный или остановленный бот полностью игнорирует сигналы, и это самая частая причина. Затем проверьте «сантехнику»: в алерте должен быть правильный, полный URL (для входов открывающий, а не закрывающий), и если вы недавно перегенерировали, алерт может всё ещё указывать на мёртвый URL. Дальше проверьте сообщение: особенно в режиме Risk Ratio payload должен совпадать с шаблоном JSON с экрана настройки бота, иначе сигнал игнорируется. На стороне TradingView убедитесь, что ваш план действительно отправляет вебхуки и что срок действия алерта не истёк и он не израсходовал свой единственный выстрел «Only Once». Наконец, если ваша сумма или автоматически рассчитанный размер в режиме Risk Ratio ниже биржевого минимума для пары, ордер отклоняется. Журнал активности бота подскажет, какая сторона дала сбой: записанный сигнал означает проблему исполнения; отсутствие записи означает, что сигнал так и не пришёл.

Обязательно ли, чтобы мои сигналы приходили из TradingView?

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

Что дальше

Вебхук-бот хорош ровно настолько, насколько хороша питающая его стратегия. Проверьте логику своих сигналов на истории с помощью статьи Бэктест торговой стратегии для криптовалюты, а если вы пропустили какую-то деталь настройки, прочитайте полное пошаговое руководство Как создать сигнального бота на Freya Finance. Если же вы предпочитаете строить логику входа внутри Freya, подход подробно разбирает Руководство по стратегии DCA-бота. А по вопросам о хранении средств и правах API-ключа смотрите В безопасности ли мои деньги на Freya Finance?