# Вебхуки 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-бота з увімкненим повторенням | --- # 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-dex-spot/vebkhuki.md?ask= ``` 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.