# Вебхуки

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

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

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

> Вебхуки пока принимаются только с серверов TradingView — никаких пользовательских IP или внешних источников.\
> Если вам нужно использовать кастомный источник вебхуков, свяжитесь с нами по адресу <support@goodcrypto.app> чтобы запросить доступ.

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

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

Вот обзорное видео:

{% embed url="<https://youtu.be/Mx-nD_p2Pgw>" %}

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

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

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

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

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fl2pfeXIwqa1tpvsFEldb%2Fimage.png?alt=media&#x26;token=99ca6c17-d547-47c7-abaf-1d1e3bb4e03a" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FlG04MgjoXROWz32j0tN4%2Fimage.png?alt=media&#x26;token=08009fa1-7757-4495-b60e-1165e12887b3" alt="" width="375"><figcaption></figcaption></figure>

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

| Действие                          | Поддерживается? | Примечания                                                                   |
| --------------------------------- | --------------- | ---------------------------------------------------------------------------- |
| Отменить ордер                    | ✅               | Всегда показывается в деталях                                                |
| Триггер лимитного ордера          | ✅               | Нужно выбрать вебхук при настройке                                           |
| Активировать трейлинг-ордер       | ✅               | Начало трейлинга = вебхук                                                    |
| Триггер тейк-профита / стоп-лосса | ✅               | По желанию — запуск через вебхук                                             |
| DCA-бот — вход                    | ✅               | Входная покупка/продажа через вебхук (должно быть установлено при настройке) |
| DCA-бот — выход                   | ✅               | Закрытие позиции через вебхук (всегда доступно)                              |

{% 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 strategy для поддержки повторяющихся мультидействийных сделок, но пока DCA-бот предоставляет гибкий способ повторять вашу стратегию, управляемую вебхуками.

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

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

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNUBBrWgJqqqvjcnLBw7C%2Fimage.png?alt=media&#x26;token=ced6146d-5d8e-4496-94bc-0cb08cb57282" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

Вы можете:

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

Это делает возможным разработку:

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

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

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

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

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

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Ffg4E339WmltyEDaiNjma%2Fimage.png?alt=media&#x26;token=0ee7cab9-7575-4ac2-89c4-841693b2ba77" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2Fc3oNniHr6lmTUwc8qQ7V%2Fimage.png?alt=media&#x26;token=9787c6e6-5744-48cc-8ae1-a891fd775e8e" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

### Резюме

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