> 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/torgovlya-na-cex/vebkhuki.md).

# Вебхуки

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

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

> В ближайшем будущем мы запустим новый [бот стратегии TradingView](/goodcryptox-ru/perp-dex/funkcionalnost-kotoraya-skoro-poyavitsya/bot-strategii-tradingview.md) который будет поддерживать полные инструкции стратегии через вебхуки, включая динамический выбор инструмента, объёмы, типы ордеров и логику для нескольких символов — фактически выступая в роли слоя API. Следите за обновлениями

### Безопасность и доступ

* Пока вебхуки принимаются только с серверов TradingView — никаких пользовательских IP или внешних источников.
* Если вам нужно использовать собственный источник вебхуков, свяжитесь с нами по адресу <support@goodcrypto.app> чтобы запросить доступ.
* Вебхуки доступны только для пользователей с активным PRO [планом](/goodcryptox-ru/ekosistema/tarifnye-plany.md) или выше.

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

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

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

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

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

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

<figure><img src="/files/55d8a3912da6e7c6d410b8ed9c61abae4c374033" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/791d6bfed182e335d7a23f52d0e43da488d9056b" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/a394bb8c8b20a17cd3da21d741d36fed14e43d1e" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/4df2a785acb1be9679b74b1c6c3a2eafacc9ffe9" alt="" width="563"><figcaption></figcaption></figure>

> **Отменить** вебхук — всегда доступен во всех ордерах и ботах
>
> **Закрыть позицию** вебхук — всегда доступен в деталях 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/torgovlya-na-cex/funkcionalnost-kotoraya-skoro-poyavitsya/bot-strategii-tradingview.md) для поддержки повторяющихся многошаговых сделок, но тем временем DCA бот предоставляет гибкий способ повторять вашу стратегию, управляемую вебхуками.

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

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

1. Установите **условие входа** = вебхук
2. Установите **усредняющие ордера** = 0 (отключить усреднение)
3. Отключите оба **тейк**-**профит** и **стоп-лосс**
4. Включите **«Повторять при закрытии позиции»**&#x20;

<figure><img src="/files/cbd8a14bc22ec30dc0951618b941180deaab7190" alt="" width="375"><figcaption></figcaption></figure>

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

* **Enter Buy** — открывает лонг позицию
* **Enter Sell** — открывает шорт позицию
* **Закрыть позицию** — закрывает активную позицию (лонг или шорт)
* **Отменить** — останавливает бота

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

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

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

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

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

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

Вы можете:

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

Это позволяет проектировать:

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

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

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

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

**Настройка в goodcryptoX**

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

<figure><img src="/files/7afcbda0f4f09906aa5cefdc3b727514a5fde5d1" alt="" width="563"><figcaption></figcaption></figure>

**Настройка в TradingView**

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

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

<figure><img src="/files/0eceb428b713cce282eea6c6312ac2822252fd89" alt="" width="563"><figcaption></figcaption></figure>

В **настройках оповещения**включите флажок **«Webhook URL»**

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

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

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

**Настройка в goodcryptoX**

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

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

**Настройка в TradingView**

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

{% hint style="info" %}
DCA бот держит только одну позицию одновременно. Пока позиция открыта, он игнорирует новые входные вебхуки до закрытия позиции.

Если вы хотите иметь возможность одновременно открывать лонг и шорт по одному инструменту — создайте два отдельных бота и отправляйте Enter Buy одному, а Enter Sell другому
{% endhint %}

### Резюме

| Концепция               | Описание                                                                    |
| ----------------------- | --------------------------------------------------------------------------- |
| Модель триггера         | Каждое действие имеет свой URL вебхука                                      |
| Поток настройки         | Создать ордер → скопировать URL вебхука → вставить в оповещение TradingView |
| Повторяющаяся стратегия | Используйте DCA бота с включённым повторением                               |
| Доступ                  | Требуется план PRO или выше                                                 |

### Видеоуроки

#### **Введение в торговлю через вебхуки**

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **Использование DCA бота с вебхуками**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **Несколько тейк-профитов через вебхуки**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}
