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

Вебхук: что это простыми словами

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

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

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

Что такое вебхук (webhook) простыми словами

Что такое вебхук, проще всего понять на бытовом примере. Можно каждые пять минут выглядывать в окно и проверять, не приехал ли курьер. А можно оставить ему номер телефона, и он позвонит сам, когда привезёт посылку. Вебхук работает как этот звонок: адрес вы оставляете один раз, а сообщение приходит в момент события.

Слово составлено из английских web и hook («крючок»): хуком в программировании называют место, к которому можно «подцепить» свою реакцию на событие. По-русски пишут «вебхук», реже «веб-хук», а по смыслу это обратный вызов по HTTP. В англоязычной документации раздел о них обычно называется webhooks.

Как работает вебхук: событие, адрес и запрос

Схема почти везде одинаковая:

  1. Получатель создаёт адрес вебхука (webhook URL) и передаёт его отправителю.
  2. У отправителя происходит событие: прошла оплата, сработало условие, появилось сообщение.
  3. Отправитель делает HTTP-запрос на этот адрес. В теле запроса лежат данные о событии, чаще всего в формате JSON.
  4. Получатель проверяет запрос, выполняет действие и отвечает кодом статуса: принято или ошибка.

HTTP построен на обмене сообщениями: клиент отправляет запрос, сервер возвращает ответ (подробнее в обзоре HTTP на MDN). Необычно здесь то, что запрос отправляет сторона, у которой произошло событие, а не та, которой нужны данные. Если получатель в этот момент недоступен, одни отправители повторяют попытку, а другие нет, и сообщение теряется.

Вебхук и API: в чём разница

API: набор правил, по которым одна программа обращается к другой. Работая через API, клиент сам запрашивает данные и, чтобы не пропустить изменения, вынужден спрашивать регулярно. Вебхук меняет направление: сервер сам присылает данные, как только что-то изменилось, поэтому такой механизм иногда называют «обратным API».

Запрос к APIВебхук
Кто начинает обменКлиент, которому нужны данныеСторона, у которой произошло событие
Когда приходят данныеКогда клиент спросилСразу после события
Если ничего не происходитЗапросы уходят впустуюЗапросов нет
ПримерУзнать баланс, отправить заявкуСообщить об оплате, сигнале, новом сообщении

На практике одно дополняет другое: торговый бот получает сигнал по вебхуку, а заявку на биржу отправляет через API биржи по вашему API-ключу.

Где применяют вебхуки

  • Платежи. Платёжный сервис сообщает магазину, что оплата прошла.
  • Разработка. Хранилище кода запускает сборку и тесты после каждого изменения.
  • Мессенджеры и чаты. Канал получает отдельный адрес, и всё, что на него отправлено, появляется в канале как сообщение. Так боты публикуют оповещения.
  • Мониторинг. Система наблюдения сообщает, что сервер перестал отвечать.

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

Как работает вебхук в трейдинге

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

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

Слабые места схемы:

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

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

Вебхуки в Freya: сигнальный бот

В Freya вебхук служит входом для сигнального бота. Индикаторных условий входа у этого бота нет: сделку он открывает только по сигналу на свой адрес. Бот торгует на споте и фьючерсах Binance, Bybit и OKX, а адреса и правила зависят от режима:

«Пользовательский сигнал»Risk Ratio
АдресаДва: для открытия и для закрытия позицииОдин, для открытия
Тейк-профит и стоп-лоссВаши проценты в настройках ботаЦены обязательно передаются в теле запроса
Размер позицииСумма сделки из настроекРассчитывается из фиксированной суммы риска

Формулы расчёта разобраны в статье о режиме Risk Ratio.

Если бот неактивен, сигнал на открытие он отклоняет, а сигнал на закрытие всё равно обрабатывает. Freya не принимает сигналы из Telegram: сообщения в каналах бот не читает, а Telegram в Freya служит для привязки аккаунта и уведомлений.

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

Безопасность вебхука

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

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

Если вы принимаете такие запросы на своём сервере, используйте HTTPS, длинный случайный адрес и подпись запроса общим секретом, если отправитель её поддерживает.

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

Что такое вебхук простыми словами?

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

Как переводится webhook?

Дословно «веб-крючок». По смыслу это обратный вызов по HTTP, а в русских текстах обычно пишут «вебхук».

Что такое webhook URL?

Адрес, на который отправитель присылает запросы о событиях. Его выдаёт сервис-получатель: в Freya, например, адреса появляются при создании сигнального бота. Относитесь к такому адресу как к паролю.

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

Не всегда. Многие платформы графиков и сервисы оповещений позволяют вставить адрес и текст сообщения прямо в настройки. Программирование понадобится, если вы сами пишете источник сигналов или принимаете запросы на своём сервере.

Принимает ли Freya сигналы из Telegram?

Нет. Сигнальный бот Freya получает сигналы только по своим адресам вебхуков, а Telegram используется для привязки аккаунта и уведомлений. Чтобы бот получил сигнал, источник должен сам отправить запрос на его адрес.


Материал подготовлен Freya Finance и носит информационный характер. Это не индивидуальная инвестиционная рекомендация и не предложение цифровой валюты. Источники: обзор протокола HTTP на MDN (ссылка в тексте) и описание продукта Freya Finance. Торговля цифровой валютой связана с высоким риском, вплоть до полной потери вложенных средств. Обращение цифровой валюты в Российской Федерации ограничено законодательством; перед любыми операциями проверьте требования, которые к вам применяются.

Создайте аккаунт

Примените знания на практике: откройте аккаунт Freya уже сегодня.

Зарегистрироваться