Вебхуки

goodcryptoX позволяет автоматизировать торговые действия через вебхуки TradingView — мощный механизм для запуска ордеров и действий бота напрямую из ваших сигналов.

В отличие от некоторых реализаций, которые рассматривают вебхуки как программируемый API (когда вы отправляете параметризованные команды вроде "купить 3 BTC"), goodcryptoX в настоящее время поддерживает модель на основе триггеров. Каждый вебхук просто активирует предопределённое действие для конкретного ордера или бота — никакие параметры или команды не интерпретируются.

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

Вебхуки пока принимаются только с серверов TradingView — никаких кастомных IP или внешних источников. Если вам нужно использовать собственный источник вебхуков, свяжитесь с нами по адресу [email protected] чтобы запросить доступ.

Как вебхуки работают в goodcryptoX

Каждый ордер или бот действие имеет собственный выделенный URL вебхука
Вы должны сначала создать ордер или бота, чтобы получить URL (они появятся в Вебхуки разделе деталей ордера или бота)
Отправка любого пейлоуда вебхука на этот URL активирует действие

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

Поддерживаемые действия ордеров и ботов

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

Стоп-рыночные / стоп-лимит ордера — триггер
Активация трейлинга ордеров (начало трейла)
Триггеры тейк-профита и стоп-лосса
Условие входа DCA бота

После создания вы найдёте все доступные URL вебхуков в ордера или бота вашего ордера или бота:

Отменить вебхук — всегда доступен во всех ордерах и ботах
Закрыть позицию вебхук — всегда доступен в деталях DCA бота

Подведём итог:

Действие

Поддерживается?

Примечания

Отменить ордер

✅

Всегда отображается в деталях

Триггер Стоп ордера

✅

Необходимо выбрать вебхук при настройке

Активировать трейлинг ордер

✅

Начало трейла = вебхук

Триггер тейк-профита / стоп-лосса

✅

Опционально — срабатывает по вебхуку

DCA бот — вход

✅

Вход покупка/продажа через вебхук (должно быть установлено при настройке)

DCA бот — выход

✅

Закрытие позиции через вебхук (всегда доступно)

Grid бот — вход

🚫

Ещё не поддерживается

Несколько целей тейк-профита с вебхуками

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

Как настроить оповещения в TradingView

После того как вы создадите ордер или бота в goodcryptoX и скопируете URL вебхука для конкретного действия, вот как связать его с оповещениями в TradingView:

Перейдите на график в TradingView
Создайте новое оповещение на основе вашей стратегии, индикатора или условия
В настройках оповещения, поставьте галочку «Webhook URL»
Вставьте конкретный URL вебхука из раздела Вебхуки в goodcryptoX
Оставьте поле сообщения как есть (любой контент допустим — goodcryptoX пока игнорирует пейлоуд)
Сохраните оповещение

Повторяющиеся стратегии (через DCA бота)

Ордер, срабатываемый вебхуком (например, стоп-рыночный с TP и SL), — это однократная настройка. После исполнения ордера и срабатывания связанного TP или SL вся сделка считается завершённой. Если вы хотите, чтобы эта структура повторялась автоматически, это невозможно с ордерами — но это достижимо сейчас с помощью DCA бота.

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

Чистый цикл вебхуков

Чтобы настроить бота, который входит в позицию по вебхуку, выходит по вебхуку, а затем повторяет цикл:

Установите условие входа = вебхук
Установите усредняющие ордера = 0 (отключить усреднение)
Отключите оба тейк-профит и стоп-лосс
Включите «Повторять при закрытии позиции»

После запуска бота вы увидите следующие URL вебхуков в разделе Детали → Вебхуки бота:

Вход Покупка — открывает длинную позицию
Вход Продажа — открывает короткую позицию
Закрыть позицию — закрывает активную позицию (лонг или шорт)
Отменить — останавливает бота

Логика исполнения

Когда бот получает Вход Покупка, он открывает длинную позицию.
Когда он получает Вход Продажа, он открывает короткую позицию.
Бот будет реагировать только на первый вебхук входа который он получает в состоянии простоя.
Пока позиция открыта:
- Любые последующие сигналы входа игнорируются
- Бот не будет увеличивать или разворачивать текущую позицию по сигналам входа
- Единственные принятые сигналы — это закрыть позицию или сработавший TP/SL (если настроено)
После закрытия позиции (вручную, через вебхук или по SL/TP) бот сбрасывается и ждёт следующего вебхука входа.

Этот цикл продолжается, пока бот остаётся активным, позволяя вам бесконечно повторять полный цикл вход → выход → сброс.

Режим чистого вебхука vs гибридные настройки

DCA бот поддерживает несколько уровней управления, которые можно комбинировать для построения гибких стратегий:

Вход: через вебхук, сигнал или asap
Выход: через вебхук или встроенный TP/SL по цене
Усреднение: опционально; может быть отключено

Вы можете:

Запустить бота полностью по сигналам вебхуков (вход и выход)
Добавить TP/SL по цене в качестве запасных вариантов, даже если вы используете выходы по вебхуку
Добавить усредняющие ордера для дополнительной защиты

Это позволяет создавать:

Полностью автоматизированные циклические стратегии (чистый вебхук)
Ботов на основе сигналов с ручными резервными вариантами
Гибридные настройки с многоуровневыми выходами

Практические примеры стратегий с вебхуками

Пример 1: Одноразовый ордер + несколько тейк-профитов (отскок от полос Боллинджера)

Цель: Купить, когда цена пробивает нижнюю полосу Боллинджера, продавать постепенно по мере роста.

Настройка в goodcryptoX

Создайте стоп-рыночный ордер с условием срабатывания = вебхук
Добавьте три цели тейк-профита. Триггер TP = вебхук

Настройка в TradingView

Создайте четыре оповещения:

Цена пробивает нижнюю полосу → отправить на основной ордерный Триггер URL вебхука
Цена возвращается внутрь полосы → отправить на Триггер тейк-профита URL вебхука
Цена пересекает среднюю полосу → отправить на Триггер тейк-профита URL вебхука
Цена пробивает верхнюю полосу → отправить на Триггер тейк-профита URL вебхука

В настройках оповещения, поставьте галочку «Webhook URL»

Вставьте конкретный URL вебхука из раздела Вебхуки в goodcryptoX. Оставьте поле Message как есть — оно не используется.

Пример 2: Повторяющаяся стратегия с DCA ботом (Золотой/Смертельный крест)

Цель: Вход в лонг при Золотом кресте, вход в шорт при Смертельном кресте. Выход с прибылью 10% или при RSI > 70 и повторение бесконечно.

Настройка в goodcryptoX

Создайте DCA бота

Условие входа = вебхук
Усреднение = отключено (установить 0)
Тейк профит = 10%
Стоп-лосс = отключён
Включите: «Повторять при TP»

Настройка в TradingView

Создайте три оповещения на одном и том же графике:
1. SMA50 пересекает SMA200 снизу вверх → отправить на Вход Покупка вебхук
2. SMA50 пересекает SMA200 сверху вниз → отправить на Вход Продажа вебхук
3. RSI > 70 → отправить на Закрыть позицию вебхук

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

Если вы хотите иметь возможность одновременно входить в Лонг и Шорт по одному инструменту — создайте два отдельных бота и отправляйте Enter Buy одному, а Enter Sell другому

Резюме

Концепция

Описание

Модель триггера

Каждое действие имеет свой URL вебхука

Поток настройки

Создать ордер → скопировать URL вебхука → вставить в оповещение TradingView

Повторяющаяся стратегия

Используйте DCA бота с включённым повторением