# Вебхуки goodcryptoX дозволяє автоматизувати DEX-торгівлю через вебхуки TradingView — потужний механізм для запуску ордерів та дій бота безпосередньо з ваших сигналів. На відміну від деяких реалізацій, які трактують вебхуки як програмований API (коли ви відправляєте параметризовані команди на кшталт "купити 3 BTC"), наразі goodcryptoX підтримує модель на основі тригерів. Кожен вебхук просто активує заздалегідь визначену дію на конкретному ордері або боті — жодні параметри чи команди не інтерпретуються. Незабаром ми запустимо новий бот TradingView Strategy, який підтримає повні інструкції стратегії через вебхуки, включно з динамічним вибором символу, кількостей, типів ордерів та логікою для кількох символів — фактично виконуючи роль шару API. Слідкуйте за оновленнями > Поки що вебхуки приймаються лише з серверів TradingView — жодних кастомних IP або зовнішніх джерел.\ > Якщо вам потрібно використовувати власне джерело вебхуків, зв’яжіться з нами за адресою щоб запитати доступ. ### Як вебхуки працюють у goodcryptoX * Кожен ордер або бот **дія** має власний присвячений URL вебхука * Ви повинні спочатку створити ордер або бота, щоб отримати URL (вони з’являться в **Вебхуки** розділі **Деталі**) * Надсилання **будь-якого** payload вебхука на цей URL запустить дію Ось оглядове відео: {% embed url="" %} > URL-адреси вебхуків специфічні для дії. Ви повинні створити один вебхук на дію, наприклад один для входу, один для тейк-профіту, один для стоп-лосу тощо для кожного бота або ордера ### Підтримувані дії ордерів і ботів Якщо ви хочете, щоб ваш ордер або бот був **запущений вебхуком**, ви повинні вибрати вебхук як **умову тригера під час налаштування**. Це застосовується до: * Лімітні ордери тригерують * Активація трейлінг-ордера (trailing start) * Тригери тейк-профіту і стоп-лосу * Умова входу DCA-бота > **Скасувати** вебхук — завжди доступний у всіх ордерах і ботах > > **Закрити позицію** вебхук — завжди доступний у деталях DCA-бота
Після створення ви знайдете всі доступні URL вебхуків у **Деталі** вашого ордера або бота:
Підсумуємо: | Дія | Підтримується? | Примітки | | ------------------------------- | -------------- | ---------------------------------------------------------------------------- | | Скасувати ордер | ✅ | Завжди відображається в деталях | | Тригер лімітного ордера | ✅ | Потрібно вибрати вебхук під час налаштування | | Активувати трейлінг-ордер | ✅ | Початок трейлінгу = вебхук | | Тригер тейк-профіту / стоп-лосу | ✅ | Опційно: запуск через вебхук | | DCA-бот - вхід | ✅ | Вхід купівлі/продажу через вебхук (потрібно встановити під час налаштування) | | 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. Увімкніть **«Повторювати при закритті позиції»**
Після запуску бота ви побачите наступні URL вебхуків у розділі **Деталі → Вебхуки** бота: * **Enter Buy** — відкриває довгу позицію * **Закрити позицію** — закриває активну позицію (лонг або шорт) * **Скасувати** — зупиняє бота **Логіка виконання** * Коли бот отримує **Enter Buy**, він відкриває довгу позицію. * Бот буде **реагувати лише на перший вебхук входу** який він отримує у стані простою. * Поки позиція відкрита: * Будь-які подальші сигнали входу **ігноруються** * Єдині прийняті сигнали — це **закрити позицію** або спрацьований TP/SL (якщо налаштовано) * Після закриття позиції (вручну, через вебхук або через SL/TP) бот скидається і чекає наступного вебхука входу. Цей цикл триває доти, доки бот активний, дозволяючи вам необмежено повторювати повний цикл вхід → вихід → скидання. #### Режим чистого вебхука проти гібридних налаштувань DCA-бот підтримує кілька рівнів керування, які можна комбінувати для побудови гнучких стратегій: * **Вхід**: через вебхук, сигнал або миттєво * **Вихід**: через вебхук або вбудований ціновий TP/SL * **Усереднення**: опційно; можна вимкнути Ви можете: * Запустити бота повністю за сигналами вебхука (вхід і вихід) * Додати цінові TP/SL як резервні варіанти, навіть якщо ви використовуєте виходи через вебхуки * Додати усереднювальні ордери для додаткового захисту Це дозволяє розробити: * Повністю автоматизовані циклічні стратегії (чистий вебхук) * Ботів на основі сигналів з ручними страховками * Гібридні налаштування з багаторівневими виходами ### Практичні приклади стратегій з вебхуками #### Приклад 1: Одночасний ордер + кілька тейк-профітів (відскок від смуги Боллінджера) **Мета:** Купувати, коли ціна пробиває нижню смугу Боллінджера, продавати поступово в міру підйому. **Налаштування в goodcryptoX** * Створіть лімітний ордер з умовою тригера = вебхук * Додайте три цілі тейк-профіту. Тригер TP = вебхук
**Налаштування в TradingView** Створіть чотири сповіщення: 1. Ціна пробиває нижню смугу → відправити на основний **Тригер** URL вебхука ордера 2. Ціна повертається всередину смуги → відправити на **Тригер тейк-профіту** URL вебхука ордера 3. Ціна перетинає середню смугу → відправити на **Тригер тейк-профіту** URL вебхука ордера 4. Ціна пробиває верхню смугу → відправити на **Тригер тейк-профіту** URL вебхука ордера
У **налаштуваннях сповіщення**, увімкніть чекбокс **«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 → відправити на **Закрити позицію** вебхук ### Підсумок | Концепція | Опис | | --------------------- | --------------------------------------------------------------------------- | | Модель тригера | Кожна дія має власний URL вебхука | | Потік налаштування | Створити ордер → скопіювати URL вебхука → вставити у сповіщення TradingView | | Повторювана стратегія | Використовуйте DCA-бота з увімкненим повторенням |