# Вебхуки

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" 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](https://docs.goodcrypto.app/goodcryptox-ru/torgovlya-na-cex/predstoyashaya-funkcionalnost/bot-strategii-tradingview) для поддержки повторяющихся многошаговых сделок, но тем временем DCA бот предоставляет гибкий способ повторять вашу стратегию, управляемую вебхуками.

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

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

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

<figure><img src="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" 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="https://3637223854-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><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%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" 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>" %}