Вебхуки

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

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

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

Вебхуки наразі приймаються лише з серверів TradingView — жодні кастомні IP або зовнішні джерела не підтримуються. Якщо вам потрібно використовувати власне джерело вебхуків, зв’яжіться з нами за [email protected] щоб запросити доступ.

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

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

URL вебхуків є специфічними для дії, а не для користувача. Вам потрібно створити один вебхук на дію, наприклад один для входу, один для тейк-профіту, один для стоп-лоссу тощо для кожного бота або ордера

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

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

Stop-market / stop-limit ордери — тригер
Активація трейлінг-ордерів (пуск трейлінгу)
Тригери тейк-профіту і стоп-лоссу
Умова входу DCA-бота

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

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

Підсумок:

Дія

Підтримується?

Примітки

Скасувати ордер

✅

Завжди показується в деталях

Тригер Stop ордера

✅

Потрібно обрати вебхук під час налаштування

Активувати трейлінг-ордер

✅

Пуск трейлінгу = вебхук

Тригер тейк-профіту / стоп-лоссу

✅

Опціонально може бути активований вебхуком

DCA-бот — вхід

✅

Вхідна покупка/продаж через вебхук (потрібно встановити при налаштуванні)

DCA-бот — вихід

✅

Закриття позиції через вебхук (завжди доступно)

Grid-бот — вхід

🚫

Поки що не підтримується

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

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

Як налаштувати алерти в TradingView

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

Перейдіть до вашого графіка в TradingView
Створіть новий алерт на основі вашої стратегії, індикатора або умови
У налаштуваннях алерту, увімкніть чекбокс “Webhook URL”
Вставте конкретний URL вебхука з розділу Вебхуки goodcryptoX
Залиште поле повідомлення як є (будь-який вміст підходить — goodcryptoX наразі ігнорує payload)
Збережіть алерт

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

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

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

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

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

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

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

Enter Buy — відкриває довгу позицію
Enter Sell — відкриває коротку позицію
Закрити позицію — закриває активну позицію (довгу або коротку)
Відмінити — зупиняє бота

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

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

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

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

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

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

Ви можете:

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

Це робить можливим розробку:

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

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

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

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

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

Створіть stop-market ордер з умовою тригера = вебхук
Додайте три цілі тейк-профіту. Тригер TP = вебхук

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

Створіть чотири алерти:

Ціна пробиває нижню смугу → надсилати на головний ордер Тригер URL вебхука
Ціна повертається всередину смуги → надсилати на Trigger Take Profit URL вебхука
Ціна перетинає середню смугу → надсилати на Trigger Take Profit URL вебхука
Ціна пробиває верхню смугу → надсилати на Trigger Take Profit 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 → надсилати на Закрити позицію вебхук

DCA-бот утримує лише одну позицію одночасно. Поки позиція відкрита, він ігнорує нові вебхуки входу до її закриття.

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

Підсумок

Концепція

Опис

Модель тригера

Кожна дія має свій власний URL вебхука

Потік налаштування

Створити ордер → скопіювати URL вебхука → вставити в алерт TradingView

Повторювана стратегія

Використовуйте DCA-бота з увімкненим повторенням