# Вебхуки

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> чтобы запросить доступ.

### Как вебхуки работают в 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/perp-dex/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 вебхуков в разделе **Детали → Вебхуки** бота:

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

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

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

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

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

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

* **Вход**: через вебхук, сигнал или asap
* **Выход**: через вебхук или встроенный 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. Оставьте поле 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="<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>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.goodcrypto.app/goodcryptox-ru/perp-dex/vebkhuki.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
