# Вебхуки

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="/files/04c108bc76e73dad53538761ef74b82eb994f426" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/faf972da4845a3a2498adf9fc53ef22511136019" 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="/files/c72e910846cd41897c2611eccd23b0d33c6bfc36" alt="" width="375"><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

Вы можете:

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

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="/files/7ab5f466e30186e136381bb5a53d5ed1a80376db" 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-бота с включённым повторением                               |


---

# 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/torgovlya-na-dex-spot/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.
