# Вебхуки

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

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

> Незабаром ми запустимо новий [бот TradingView Strategy](/goodcryptox-uk/perp-dex/naiblizhcha-funkcionalnist/bot-strategiyi-tradingview.md) що підтримуватиме повні інструкції стратегії через вебхуки, включно з динамічним вибором символу, кількостями, типами ордерів та логікою для кількох символів — фактично виконуючи роль API-слою. Слідкуйте за оновленнями

### Безпека та доступ

* Поки що вебхуки приймаються лише з серверів TradingView — жодних користувацьких IP чи зовнішніх джерел.
* Якщо вам потрібно використовувати власне джерело вебхуків, зв'яжіться з нами за <support@goodcrypto.app> щоб запросити доступ.
* Вебхуки доступні лише для користувачів з активним PRO [планом](/goodcryptox-uk/ekosistema/plani-pidpiski.md) або вище.

### Як працюють вебхуки в goodcryptoX

* Кожен ордер або бот **дія** має власний виділений URL вебхука
* Ви повинні спочатку створити ордер або бота, щоб отримати URL (вони з’являться в **Вебхуки** розділі деталей ордера або бота **Деталі**)
* Надсилання **будь-якого** пейлоаду вебхука на цей URL активує дію

> URL вебхуків є специфічними для дії, а не для користувача. Ви повинні створити один вебхук на кожну дію, наприклад один для входу, один для тейк-профіту, один для стоп-лоссу тощо для кожного бота або ордера

### Підтримувані дії ордерів та ботів

Якщо ви хочете, щоб ваш ордер або бот був **запущений вебхуком**, ви повинні вибрати вебхук як **умову тригера під час налаштування**. Це стосується:

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

<figure><img src="/files/32a71e0084c79cf0f53a7da4eeec2ce425d4f044" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/2410a86db5428a1d6de5c5c9e73df07fb07292a8" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/fa3027254420e186214da194abfcdd8607536a6a" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/fab2a830982948dea8f8203fbc54535ea2f93977" 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 strategy](/goodcryptox-uk/torgivlya-na-cex/naiblizhcha-funkcionalnist/bot-strategiyi-tradingview.md) щоб підтримувати повторювані багатодійні трейди, але поки що DCA бот надає гнучкий спосіб повторювати вашу стратегію, керовану вебхуками.

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

Щоб налаштувати бота, який входить у позицію через вебхук, виходить через вебхук і потім повторюється:

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

<figure><img src="/files/05ad0a93dee56cee3ba8a9d1926bce92477d7e6f" alt="" width="375"><figcaption></figcaption></figure>

Після запуску бота ви побачите наступні URL вебхуків у деталях бота **Деталі → Вебхуки** розділі:

* **Enter Buy** — відкриває довгу позицію
* **Enter Sell** — відкриває коротку позицію
* **Закрити позицію** — закриває активну позицію (довгу або коротку)
* **Відмінити** — зупиняє бота

**Логіка виконання**

* Коли бот отримує **Enter Buy**, він відкриває довгу позицію.
* Коли він отримує **Enter Sell**, він відкриває коротку позицію.
* Бот буде **реагувати лише на перший вхідний вебхук** який він отримує в стані простою.
* Поки позиція відкрита:
  * Будь-які подальші сигнали входу **ігноруються**
  * Бот не збільшуватиме й не реверсуватиме поточну позицію на сигнали входу
  * Єдині прийняті сигнали — це **закрити позицію** або спрацьований TP/SL (якщо налаштовано)
* Після закриття позиції (вручну, через вебхук або через SL/TP) бот скидається і чекає наступного вебхука входу.

Цей цикл триває доти, поки бот активний, дозволяючи повторювати повний цикл вхід → вихід → скидання безкінечно.

#### Чистий режим вебхуків проти гібридних налаштувань

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

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

Ви можете:

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

Це дозволяє створювати:

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

### Практичні приклади стратегій з вебхуками

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

**Мета:** Купувати, коли ціна пробиває нижню смугу Боллінджера, продавати поступово під час підйому.

**Налаштування в goodcryptoX**

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

<figure><img src="/files/6c51dbe57c096604d07f0063c467123eb2516e43" alt="" width="563"><figcaption></figcaption></figure>

**Налаштування в TradingView**

Створіть чотири алерти:

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

<figure><img src="/files/53043439866e875d60442a7cd08591340fe9b6b8" 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>" %}


---

# 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-uk/torgivlya-na-cex/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.
