> 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/dex-trading-spot/webhooks.md).

# Вебхуки

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

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6F4aTDWRVM1Gw56c6pJI%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" 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%2F6F4aTDWRVM1Gw56c6pJI%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" 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%2F6F4aTDWRVM1Gw56c6pJI%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

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

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

#### Чистый режим вебхуков 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%2F6F4aTDWRVM1Gw56c6pJI%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" 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%2F6F4aTDWRVM1Gw56c6pJI%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

В **настройках оповещения**, включите чекбокс **«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 → отправить на **Закрыть позицию** вебхук

### Итоги

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