> 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/torgivlya-na-cex/vebkhuki.md). # Вебхуки goodcryptoX дозволяє автоматизувати торгові дії через вебхуки TradingView — потужний механізм для запуску ордерів та дій ботів безпосередньо з ваших сигналів. На відміну від деяких реалізацій, що трактують вебхуки як програмований API (куди ви надсилаєте параметризовані команди на кшталт "купити 3 BTC"), goodcryptoX наразі підтримує модель на основі тригерів. Кожен вебхук просто активує заздалегідь визначену дію для конкретного ордера або бота — жодні параметри чи команди не інтерпретуються. > Незабаром ми запустимо новий [бот TradingView Strategy](/goodcryptox-uk/perp-dex/naiblizhcha-funkcionalnist/bot-strategiyi-tradingview.md) що підтримуватиме повні інструкції стратегії через вебхуки, включно з динамічним вибором символу, кількостями, типами ордерів та логікою для кількох символів — фактично виконуючи роль API-слою. Слідкуйте за оновленнями ### Безпека та доступ * Поки що вебхуки приймаються лише з серверів TradingView — жодних користувацьких IP чи зовнішніх джерел. * Якщо вам потрібно використовувати власне джерело вебхуків, зв'яжіться з нами за щоб запросити доступ. * Вебхуки доступні лише для користувачів з активним PRO [планом](/goodcryptox-uk/ekosistema/plani-pidpiski.md) або вище. ### Як працюють вебхуки в goodcryptoX * Кожен ордер або бот **дія** має власний виділений URL вебхука * Ви повинні спочатку створити ордер або бота, щоб отримати URL (вони з’являться в **Вебхуки** розділі деталей ордера або бота **Деталі**) * Надсилання **будь-якого** пейлоаду вебхука на цей URL активує дію > URL вебхуків є специфічними для дії, а не для користувача. Ви повинні створити один вебхук на кожну дію, наприклад один для входу, один для тейк-профіту, один для стоп-лоссу тощо для кожного бота або ордера ### Підтримувані дії ордерів та ботів Якщо ви хочете, щоб ваш ордер або бот був **запущений вебхуком**, ви повинні вибрати вебхук як **умову тригера під час налаштування**. Це стосується: * Стоп-ринкові / стоп-лімітні ордери — тригер * Активація трейлінг-ордерів (trailing start) * Тригер для тейк-профіту та стоп-лоссу * Умова входу для DCA ботів
Після створення ви знайдете всі доступні URL вебхуків у **Деталі** вашого ордера або бота:
> **Відмінити** вебхук — завжди доступний у всіх ордерах та ботах > > **Закрити позицію** вебхук — завжди доступний у деталях 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](/goodcryptox-uk/torgivlya-na-cex/naiblizhcha-funkcionalnist/bot-strategiyi-tradingview.md) щоб підтримувати повторювані багатодійні трейди, але поки що DCA бот надає гнучкий спосіб повторювати вашу стратегію, керовану вебхуками. #### Чистий цикл вебхуків Щоб налаштувати бота, який входить у позицію через вебхук, виходить через вебхук і потім повторюється: 1. Встановіть **умову входу** = вебхук 2. Встановіть **усереднюючі ордери** = 0 (відключити усереднення) 3. Вимкніть обидва **тейк**-**профіт** і **стоп-лосс** 4. Увімкніть **«Повторювати при закритті позиції»**
Після запуску бота ви побачите наступні URL вебхуків у деталях бота **Деталі → Вебхуки** розділі: * **Enter Buy** — відкриває довгу позицію * **Enter Sell** — відкриває коротку позицію * **Закрити позицію** — закриває активну позицію (довгу або коротку) * **Відмінити** — зупиняє бота **Логіка виконання** * Коли бот отримує **Enter Buy**, він відкриває довгу позицію. * Коли він отримує **Enter Sell**, він відкриває коротку позицію. * Бот буде **реагувати лише на перший вхідний вебхук** який він отримує в стані простою. * Поки позиція відкрита: * Будь-які подальші сигнали входу **ігноруються** * Бот не збільшуватиме й не реверсуватиме поточну позицію на сигнали входу * Єдині прийняті сигнали — це **закрити позицію** або спрацьований TP/SL (якщо налаштовано) * Після закриття позиції (вручну, через вебхук або через SL/TP) бот скидається і чекає наступного вебхука входу. Цей цикл триває доти, поки бот активний, дозволяючи повторювати повний цикл вхід → вихід → скидання безкінечно. #### Чистий режим вебхуків проти гібридних налаштувань DCA бот підтримує кілька рівнів керування, які можна комбінувати для побудови гнучких стратегій: * **Вхід**: через вебхук, сигнал або asap * **Вихід**: через вебхук або вбудований ціновий 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 → надішліть на **Закрити позицію** вебхук {% hint style="info" %} DCA бот утримує лише одну позицію одночасно. Поки позиція відкрита, він ігнорує нові вебхуки входу до закриття позиції. Якщо ви хочете мати можливість одночасно відкривати довгі і короткі позиції на одному інструменті — створіть два окремі боти і надсилайте Enter Buy одному, а Enter Sell іншому {% endhint %} ### Резюме | Поняття | Опис | | --------------------- | ---------------------------------------------------------------------- | | Модель тригера | Кожна дія має свій власний URL вебхука | | Порядок налаштування | Створити ордер → скопіювати URL вебхука → вставити в алерт TradingView | | Повторювана стратегія | Використовуйте DCA бота з увімкненим повторенням | | Доступ | Вимагається план PRO або вище | ### Відеоуроки #### **Вступ до торгівлі через вебхуки** {% embed url="" %} #### **Використання DCA бота з вебхуками** {% embed url="" %} #### **Кілька тейк-профітів через вебхуки** {% embed url="" %}