> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-ru/perp-dex/vebkhuki.md). # Вебхуки goodcryptoX позволяет автоматизировать торговые действия через вебхуки TradingView — мощный механизм для запуска ордеров и действий бота напрямую из ваших сигналов. В отличие от некоторых реализаций, которые рассматривают вебхуки как программируемый API (когда вы отправляете параметризованные команды вроде "купить 3 BTC"), goodcryptoX в настоящее время поддерживает модель на основе триггеров. Каждый вебхук просто активирует предопределённое действие для конкретного ордера или бота — никакие параметры или команды не интерпретируются. В ближайшем будущем мы запустим новый [бот стратегии TradingView](/goodcryptox-ru/perp-dex/funkcionalnost-kotoraya-skoro-poyavitsya/bot-strategii-tradingview.md) который будет поддерживать полные инструкции стратегии через вебхуки, включая динамический выбор символа, количества, типы ордеров и логику для нескольких символов — фактически выступая в роли слоя API. Следите за обновлениями > Вебхуки пока принимаются только с серверов TradingView — никаких кастомных IP или внешних источников.\ > Если вам нужно использовать собственный источник вебхуков, свяжитесь с нами по адресу чтобы запросить доступ. ### Как вебхуки работают в goodcryptoX * Каждый ордер или бот **действие** имеет собственный выделенный URL вебхука * Вы должны сначала создать ордер или бота, чтобы получить URL (они появятся в **Вебхуки** разделе деталей **ордера или бота**) * Отправка **любого** пейлоуда вебхука на этот URL активирует действие > URL вебхуков специфичны для действия, а не для пользователя. Вы должны создать по одному вебхуку на каждое действие, например один для входа, один для тейк-профита, один для стоп-лосса и т.д. для каждого бота или ордера ### Поддерживаемые действия ордеров и ботов Если вы хотите, чтобы ваш ордер или бот **активировались вебхуком**, вы должны выбрать вебхук как **условие срабатывания при настройке**. Это относится к: * Стоп-рыночные / стоп-лимит ордера — триггер * Активация трейлинга ордеров (начало трейла) * Триггеры тейк-профита и стоп-лосса * Условие входа DCA бота
После создания вы найдёте все доступные URL вебхуков в **ордера или бота** вашего ордера или бота:
> **Отменить** вебхук — всегда доступен во всех ордерах и ботах > > **Закрыть позицию** вебхук — всегда доступен в деталях DCA бота Подведём итог: | Действие | Поддерживается? | Примечания | | --------------------------------- | --------------- | ------------------------------------------------------------------------- | | Отменить ордер | ✅ | Всегда отображается в деталях | | Триггер Стоп ордера | ✅ | Необходимо выбрать вебхук при настройке | | Активировать трейлинг ордер | ✅ | Начало трейла = вебхук | | Триггер тейк-профита / стоп-лосса | ✅ | Опционально — срабатывает по вебхуку | | DCA бот — вход | ✅ | Вход покупка/продажа через вебхук (должно быть установлено при настройке) | | DCA бот — выход | ✅ | Закрытие позиции через вебхук (всегда доступно) | | Grid бот — вход | 🚫 | Ещё не поддерживается | {% hint style="info" %} **Несколько целей тейк-профита с вебхуками** Если вы настроите группу тейк-профитов, используя вебхук в качестве метода триггера, они все будут использовать один и тот же URL вебхука. Каждый раз при срабатывании вебхука выполнится следующий ордер TP в последовательности — по очереди. {% endhint %} ### Как настроить оповещения в TradingView После того как вы создадите ордер или бота в goodcryptoX и скопируете URL вебхука для конкретного действия, вот как связать его с оповещениями в TradingView: 1. Перейдите на график в TradingView 2. Создайте новое оповещение на основе вашей стратегии, индикатора или условия 3. В **настройках оповещения**, поставьте галочку **«Webhook URL»** 4. Вставьте конкретный URL вебхука из раздела Вебхуки в goodcryptoX 5. Оставьте поле **сообщения** как есть (любой контент допустим — goodcryptoX пока игнорирует пейлоуд) 6. Сохраните оповещение ### Повторяющиеся стратегии (через DCA бота) Ордер, срабатываемый вебхуком (например, стоп-рыночный с TP и SL), — это **однократная настройка**. После исполнения ордера и срабатывания связанного TP или SL вся сделка считается завершённой. Если вы хотите, чтобы эта структура **повторялась автоматически**, это невозможно с ордерами — но это достижимо сейчас с помощью DCA бота. Вскоре мы представим выделенный [бот стратегии TradingView](/goodcryptox-ru/perp-dex/funkcionalnost-kotoraya-skoro-poyavitsya/bot-strategii-tradingview.md) чтобы поддерживать повторяющиеся мульти-действия торгов, но пока DCA бот предоставляет гибкий способ повторять вашу стратегию, управляемую вебхуками. #### Чистый цикл вебхуков Чтобы настроить бота, который входит в позицию по вебхуку, выходит по вебхуку, а затем повторяет цикл: 1. Установите **условие входа** = вебхук 2. Установите **усредняющие ордера** = 0 (отключить усреднение) 3. Отключите оба **тейк**-**профит** и **стоп-лосс** 4. Включите **«Повторять при закрытии позиции»**
После запуска бота вы увидите следующие URL вебхуков в разделе **Детали → Вебхуки** бота: * **Вход Покупка** — открывает длинную позицию * **Вход Продажа** — открывает короткую позицию * **Закрыть позицию** — закрывает активную позицию (лонг или шорт) * **Отменить** — останавливает бота **Логика исполнения** * Когда бот получает **Вход Покупка**, он открывает длинную позицию. * Когда он получает **Вход Продажа**, он открывает короткую позицию. * Бот будет **реагировать только на первый вебхук входа** который он получает в состоянии простоя. * Пока позиция открыта: * Любые последующие сигналы входа **игнорируются** * Бот не будет увеличивать или разворачивать текущую позицию по сигналам входа * Единственные принятые сигналы — это **закрыть позицию** или сработавший TP/SL (если настроено) * После закрытия позиции (вручную, через вебхук или по SL/TP) бот сбрасывается и ждёт следующего вебхука входа. Этот цикл продолжается, пока бот остаётся активным, позволяя вам бесконечно повторять полный цикл вход → выход → сброс. #### Режим чистого вебхука vs гибридные настройки DCA бот поддерживает несколько уровней управления, которые можно комбинировать для построения гибких стратегий: * **Вход**: через вебхук, сигнал или asap * **Выход**: через вебхук или встроенный TP/SL по цене * **Усреднение**: опционально; может быть отключено Вы можете: * Запустить бота полностью по сигналам вебхуков (вход и выход) * Добавить TP/SL по цене в качестве запасных вариантов, даже если вы используете выходы по вебхуку * Добавить усредняющие ордера для дополнительной защиты Это позволяет создавать: * Полностью автоматизированные циклические стратегии (чистый вебхук) * Ботов на основе сигналов с ручными резервными вариантами * Гибридные настройки с многоуровневыми выходами ### Практические примеры стратегий с вебхуками #### Пример 1: Одноразовый ордер + несколько тейк-профитов (отскок от полос Боллинджера) **Цель:** Купить, когда цена пробивает нижнюю полосу Боллинджера, продавать постепенно по мере роста. **Настройка в goodcryptoX** * Создайте стоп-рыночный ордер с условием срабатывания = вебхук * Добавьте три цели тейк-профита. Триггер TP = вебхук
**Настройка в TradingView** Создайте четыре оповещения: 1. Цена пробивает нижнюю полосу → отправить на основной ордерный **Триггер** URL вебхука 2. Цена возвращается внутрь полосы → отправить на **Триггер тейк-профита** URL вебхука 3. Цена пересекает среднюю полосу → отправить на **Триггер тейк-профита** URL вебхука 4. Цена пробивает верхнюю полосу → отправить на **Триггер тейк-профита** 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 → отправить на **Закрыть позицию** вебхук {% hint style="info" %} DCA бот удерживает только одну позицию одновременно. Пока позиция открыта, он игнорирует новые вебхуки входа до закрытия позиции. Если вы хотите иметь возможность одновременно входить в Лонг и Шорт по одному инструменту — создайте два отдельных бота и отправляйте Enter Buy одному, а Enter Sell другому {% endhint %} ### Резюме | Концепция | Описание | | ----------------------- | --------------------------------------------------------------------------- | | Модель триггера | Каждое действие имеет свой URL вебхука | | Поток настройки | Создать ордер → скопировать URL вебхука → вставить в оповещение TradingView | | Повторяющаяся стратегия | Используйте DCA бота с включённым повторением | ### Видеоуроки #### **Введение в торговлю через вебхуки** {% embed url="" %} #### **Использование DCA бота с вебхуками** {% embed url="" %} #### **Несколько тейк-профитов с вебхуками** {% embed url="" %}