# Вебхуки

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="https://934205624-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://934205624-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://934205624-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://934205624-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 strategy](https://docs.goodcrypto.app/goodcryptox-uk/torgovlya-na-cex/maibutnii-funkcional/bot-strategiyi-tradingview) щоб підтримувати повторювані багатодійні трейди, але поки що DCA бот надає гнучкий спосіб повторювати вашу стратегію, керовану вебхуками.

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

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

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

<figure><img src="https://934205624-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 вебхуків у деталях бота **Деталі → Вебхуки** розділі:

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

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

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

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

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

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

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

Ви можете:

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

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

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

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

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

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

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

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

<figure><img src="https://934205624-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://934205624-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>" %}