> For the complete documentation index, see [llms.txt](https://docs.goodcrypto.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.goodcrypto.app/goodcryptox-uk/dex-trading-spot/webhooks.md).

# Вебхуки

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

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

Найближчим часом ми запустимо нового бота TradingView Strategy, який підтримуватиме повні інструкції стратегії через вебхуки, зокрема динамічний вибір символів, кількостей, типів ордерів і багатосимвольну логіку — фактично виступаючи як API-шар. Слідкуйте за оновленнями

> Вебхуки наразі приймаються лише із серверів TradingView — жодних власних IP-адрес або зовнішніх джерел.\
> Якщо вам потрібно використовувати власне джерело вебхука, зв’яжіться з нами за адресою <support@goodcrypto.app> щоб запросити доступ.

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

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

Ось відеоогляд:

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

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

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

* Спрацювання лімітних ордерів
* Активація трейлінг-ордера (початок трейлінгу)
* Тригерів тейк-профіту та стоп-лоссу
* Умова входу бота DCA

> **Скасувати** вебхук — завжди доступний у всіх ордерах і ботах
>
> **Закрити позицію** вебхук — завжди доступний у деталях DCA-бота

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Підсумуємо:

| Дія                              | Підтримується? | Примітки                                                          |
| -------------------------------- | -------------- | ----------------------------------------------------------------- |
| Скасувати ордер                  | ✅              | Завжди показується в деталях                                      |
| Спрацювання лімітного ордера     | ✅              | Потрібно вибрати вебхук під час налаштування                      |
| Активувати трейлінговий ордер    | ✅              | Старт трейлінгу = вебхук                                          |
| Тригер тейк-профіту / стоп-лоссу | ✅              | За бажанням запускається вебхуком                                 |
| DCA-бот - вхід                   | ✅              | Вхід buy/sell через вебхук (потрібно задати під час налаштування) |
| DCA-бот - вихід                  | ✅              | Закриття позиції через вебхук (завжди доступно)                   |

{% hint style="info" %}
**Кілька цілей тейк-профіту з вебхуками**

Якщо ви налаштуєте групу тейк-профіту, використовуючи вебхук як метод тригера, усі вони матимуть однакову URL-адресу вебхука. Щоразу, коли вебхук спрацьовує, виконуватиметься наступний ордер TP у послідовності — один за одним.
{% endhint %}

### Як налаштувати сповіщення в TradingView

Після того як ви створите свій ордер або бота в goodcryptoX і скопіюєте URL-адресу вебхука для конкретної дії, ось як прив’язати її до ваших сповіщень TradingView:

1. Перейдіть до свого графіка в TradingView
2. Створіть нове сповіщення на основі вашої стратегії, індикатора або умови
3. У **налаштуваннях сповіщення**, увімкніть прапорець **“Webhook URL”**
4. Вставте конкретну URL-адресу вебхука з goodcryptoX **Доступні вебхуки** розділ
5. Залиште **поле повідомлення** без змін (будь-який вміст підходить — goodcryptoX поки що ігнорує payload)
6. Збережіть сповіщення

### Повторювані стратегії (через DCA-бот)

Ордер, що запускається вебхуком (наприклад, лімітний з TP і SL), є **одноразове налаштування**. Після виконання ордера та спрацювання пов’язаного TP або SL вся угода завершується. Якщо ви хочете, щоб ця структура **автоматично повторювалася**, з ордерами це неможливо — але це вже можна реалізувати за допомогою DCA-бота.

Незабаром ми представимо окремого бота TradingView Strategy для підтримки повторюваних угод із кількома діями, а поки що бот DCA надає гнучкий спосіб повторювати вашу стратегію, керовану вебхуками.

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

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

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

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

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

* **Вхід Buy** — відкриває Long-позицію
* **Закрити позицію** — закриває активну позицію (long або short)
* **Скасувати** — зупиняє бота

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

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

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

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

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

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

Ви можете:

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

Це дає змогу створювати:

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

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

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

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

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

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

<figure><img src="https://934205624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><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%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

У **налаштуваннях сповіщення**, увімкніть прапорець **“Webhook URL”**

Вставте конкретну URL-адресу вебхука з goodcryptoX **Доступні вебхуки** розділ. Поле Message залиште без змін — воно не використовується.

#### Приклад 2: Стратегія повторення з DCA-ботом (Golden/Death Cross)

**Мета:** Вхід у long на Golden Cross, вхід у short на Death Cross. Вихід із прибутком 10% або коли RSI > 70, і повторювати безкінечно.

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

Створіть DCA-бота

* Умова входу = вебхук
* Усереднення = вимкнено (встановіть 0)
* Тейк-профіт = 10%
* Стоп-лосс = вимкнено
* Увімкніть: "Повторювати після TP"

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

* Створіть три сповіщення на одному й тому самому графіку:
  1. SMA50 перетинає SMA200 вгору → надіслати до **Вхід Buy** вебхук
  2. SMA50 перетинає SMA200 вниз → надіслати до **Вхід Sell** вебхук
  3. RSI > 70 → надіслати до **Закрити позицію** вебхук

### Підсумок

| Концепція             | Опис                                                                             |
| --------------------- | -------------------------------------------------------------------------------- |
| Модель тригера        | Кожна дія має власну URL-адресу вебхука                                          |
| Потік налаштування    | Створіть ордер → скопіюйте URL-адресу вебхука → вставте в сповіщення TradingView |
| Повторювана стратегія | Використовуйте DCA-бота з увімкненим повторенням                                 |
