🔗Вебхуки

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

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

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

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

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

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

  • Ви повинні спочатку створити ордер або бота, щоб отримати URL (вони з’являться в Вебхуки розділі Деталі)

  • Надсилання будь-якого payload вебхука на цей URL запустить дію

Ось оглядове відео:

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

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

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

  • Лімітні ордери тригерують

  • Активація трейлінг-ордера (trailing start)

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

  • Умова входу DCA-бота

Скасувати вебхук — завжди доступний у всіх ордерах і ботах

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

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

Підсумуємо:

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

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

Завжди відображається в деталях

Тригер лімітного ордера

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

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

Початок трейлінгу = вебхук

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

Опційно: запуск через вебхук

DCA-бот - вхід

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

DCA-бот - вихід

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

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

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

Як налаштувати сповіщення в 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-бота з увімкненим повторенням

Last updated