> 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/sex-trading/webhooks.md).

# Вебхуки

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

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

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

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

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

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

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

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

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

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

* Тригера для stop-market / stop-limit ордерів
* Активації трейлінгових ордерів (старт трейлінгу)
* Тригерів тейк-профіту та стоп-лоссу
* Умови входу 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="563"><figcaption></figcaption></figure>

<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="563"><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="563"><figcaption></figcaption></figure>

<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="563"><figcaption></figcaption></figure>

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

Підсумуємо:

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

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

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

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

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

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

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

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

Незабаром ми представимо окремий [бот TradingView strategy](https://docs.goodcrypto.app/goodcryptox-uk/sex-trading/upcoming-functionality/tradingview-strategy-bot.md) для підтримки повторюваних багатодійних угод, але тим часом 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-позицію
* **Вхід Sell** — відкриває Short-позицію
* **Закрити позицію** — закриває активну позицію (long або short)
* **Скасувати** — зупиняє бота

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

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

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

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

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

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

Ви можете:

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

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

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

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

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

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

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

* Створіть stop-market ордер з умовою тригера = вебхук
* Додайте три цілі тейк-профіту. 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="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%2FT3cuH7LSEUPoz7r3Xzbm%2Fuploads%2Fgit-blob-e4fe6d10ec72c31c3a97b73468449bf13541eb0d%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

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

Вставте конкретну URL-адресу вебхука з розділу Webhooks у 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 → надіслати до **Закрити позицію** вебхука

{% hint style="info" %}
DCA-бот тримає лише одну позицію одночасно. Поки позиція відкрита, він ігнорує нові вебхуки входу, доки позиція не буде закрита.

Якщо ви хочете мати можливість відкривати Long і Short позиції на одному й тому самому інструменті паралельно — створіть два окремі боти та надсилайте Enter Buy одному, а Enter Sell іншому
{% endhint %}

### Підсумок

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

### Відеоуроки

#### **Вступ до торгівлі з вебхуками**

#### **Використання DCA-бота з вебхуками**

#### **Кілька тейк-профітів із вебхуками**
