Як використовувати та налаштовувати сигнальну торгівлю через вебхуки на Bybit

logo
Востаннє оновлено 2026-03-03 18:23:38
Поширити

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


Перш ніж почати використовувати сигнальну торгівлю через вебхук, прочитайте важливі примітки нижче:

— Переконайтеся, що ви використовуєте платну підписку на TradingView (Essential/Plus/Premium), щоб мати можливість використовувати вебхуки.

— НЕ повідомляйте URL-адресу свого вебхука іншим особам, оскільки ви можете отримувати фальшиві/шахрайські повідомлення або фальшиві ордери, розміщені від інших осіб.

— Усі отримані сповіщення TradingView надсилаються лише від імені налаштувань користувача, тому Bybit не несе відповідальності за будь-які торгові втрати, що виникають через це.

— Зверніть увагу, що можуть існувати ризики втрати або затримки сигналу, оскільки активація сигналів залежить від сторонньої платформи.

— Ця функція доступна виключно для торгівлі деривативами, зокрема USDT безстроковими, безстроковими контрактами USDC, інверсними безстроковими та інверсними ф’ючерсами на офіційному вебсайті Bybit. Для цього на вашому єдиному торговому акаунті має бути достатньо коштів.




У наступних розділах ми розповімо вам про покроковий процес налаштування та використання сигнальної торгівлі через вебхуки на Bybit. Перш ніж почати, переконайтеся, що на вашому акаунті є достатньо коштів.



  1. Створіть вебхук

  2. Запуск стратегії на TradingView

  3. Переглянути деталі про сигнал

  4. Призупинити або припинити сигнали через вебхук

  5. Обмеження ордерів





Створіть вебхук

Крок 1. У вкладці Торгівля перейдіть на сторінку контракту, яким ви хочете торгувати, натисніть Інструменти в зоні ордера, а потім виберіть Сигнальна торгівля через вебхуки.







Крок 2. Натисніть Створити. Переконайтеся, що ви розумієте принцип роботи цієї функції. Для отримання додаткової інформації про те, як здійснювати сигнальну торгівлю через вебхуки, подивіться навчальне відео та натисніть Підтверджую, що вказані вище умови виконані.







Крок 3. Щоб налаштувати вебхук, виконайте такі дії:

  1. Виберіть символ. Виберіть бажаний символ для торгівлі через вебхук. Переконайтеся, що ця примітка відповідає символу, який ви використовуєте для стратегії TradingView.
  2. Режим позиції: односторонній режим. Переконайтеся, що режим позиції для символу, для якого ви реалізовуєте стратегію, встановлено в односторонній, оскільки автоматична торгівля в режимі хеджування позиції не підтримується.
  3. Назва сигналу. Уведіть назву сигналу для вашої стратегії TradingView.


Потім натисніть Створити вебхук.



Примітки.

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

— Зверніть увагу, що ви повинні створити вебхук окремо для кожної торгової пари.



Вітаємо! Ваш вебхук успішно створено.








Запуск стратегії на TradingView

Крок 1. Створивши вебхук, натисніть відповідний контракт, щоб запустити стратегію на TradingView (якщо необхідно).







Крок 2. На сторінці TradingView натисніть Тестер стратегій, щоб завантажити свою стратегію.


Зверніть увагу, що сигнальна торгівля через вебхуки призначена виключно для реалізації стратегій, і вона не реагує на індикатори. Щоб визначити, чи використовується індикатор або стратегія у вашому графіку, перевірте початковий сегмент вихідного коду Pine Script. Якщо в ньому зазначено Стратегія, застосовується стратегія. З іншого боку, якщо на екрані з’являється Індикатор, у вашому графіку активний індикатор.







Крок 3. Відкрийте налаштування та параметри стратегії.

  1. Встановіть початковий капітал рівним балансу вашого акаунту Bybit
  2. Уведіть бажану кількість для кожного ордера. Ордери розміщуватимуться для вас саме з такою кількістю після отримання сигналу.


Примітки:

— Для інверсних контрактів наразі підтримується лише розмір ордерів у контрактах. Введення розміру ордера в USD або % від капіталу може призвести до помилки розміщення ордера. Це пов'язано з різною логікою розрахунку вартості контракту між TradingView і Bybit.

— Якщо ви вводите розмір ордера в контрактах, будь ласка, зверніть увагу, що одиниця контракту для інверсного контракту дорівнює 1 USD, в той час як для контрактів USDT або USDC, наприклад, BTCUSDT або BTC-PERP, 1 контракт дорівнює 1 BTC.







Крок 4. Створіть сповіщення про стратегію для вашої стратегії.

Параметр

Значення

Опис

symbol

{{ticker}} from TradingView

Символ оповіщення

side

  1. {{strategy.order.action}} from TradingView
  2. ENTER_LONG
  3. EXIT_LONG
  4. ENTER_SHORT
  5. EXIT_SHORT

Підтримується лише односторонній режим. Ви можете вибрати сторону для свого ордера у спадному меню.


Сторона Tradingview означає, що немає фіксованого напрямку торгівлі — ордери розміщуватимуться на основі напрямку стратегії TradingView.


trigger_time

{{timenow}} from TradingView

Це час спрацювання сповіщення. Вам не потрібно вносити зміни в цей параметр.

strategy_id

Created by Bybit upon signal trigger

Ідентифікатор стратегії цього сповіщення вебхука

amount_type

  1. absolute.quantity
  2. position.percentage
  1. Ви можете вибрати тип суми на сторінці налаштувань вебхука або відредагувати значення параметра безпосередньо в шаблоні, вставленому в TradingView.
  2. Тип суми є необов’язковим і за замовчуванням має абсолютне значення (value=absolute.quantity).
  3. Абсолютне значення означає, що вебхук розмістить ваш ордер на основі налаштованої кількості.
  4. Вибір % позиції (value=position.percentage) доступний лише для ордера на вихід. Він закриває вашу позицію на основі вибраного відсотка відкритої позиції.


quantity

  1. strategy.order.contracts
  2. Contract quantity
  3. Position percentage
  1. Якщо встановлена кількість дорівнює {{strategy.order.contracts}}, вебхук розмістить ваш ордер на основі налаштувань у TradingView.
  2. Ви також можете ввести конкретну кількість у самому шаблоні, і це замінить вихідний сигнал. Візьмемо для прикладу BTC: якщо ви встановили "quantity": "1". Для лінійних контрактів USDT/USDC 1 контракт дорівнює 1 BTC. Для інверсного контракту 1 контракт дорівнює 1 USD.
  3. Якщо вибраний вами тип суми — це відсоток позиції, то встановлена кількість буде відсотком позиції, з якої ви хочете вийти (для виходу з лонг- та шорт-позиції), плаваюче значення буде в діапазоні [0.01, 100] у %. Закриття позиції у відсотках щоразу базується на останній кількості відкритих позицій.

price

Trigger price from tradingview strategy

Це результат ціни, за якою спрацювало сповіщення. Вам не потрібно вносити зміни в цей параметр.

max_lag

Non-negative integer value between [5, 300].

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







Крок 5. Натисніть значок Сповіщення на тестері стратегії, щоб створити сповіщення для вашої стратегії, та вставте шаблон повідомлення та URL-адресу вебхука у спливне вікно «Сповіщення».



Примітки.

— Ви можете скопіювати шаблон повідомлення зі сторінки Bybit і вставити його у вікно повідомлення на вкладці налаштувань сповіщень.



URL-адресу вебхука можна знайти на сторінці Bybit, і її слід вставити в поле URL-адреси вебхука на вкладці сповіщень.







Крок 6. Встановіть тип ордера після спрацювання сигналу та TP/SL, якщо ви хочете його налаштувати.


  1. Типи ордерів: ви можете встановити ринковий або лімітний ордер.
  2. Ринковий ордер виконується негайно після отримання сигналу TradingView.
  3. Лімітний ордер розміщується за вказаною ціною після отримання сигналу. Для лімітних ордерів ви можете визначити, наскільки далеко лімітна ціна встановлюється відносно тригерної ціни

Щойно сповіщення спрацює, буде розміщено відповідний ордер.

  1. Ордери в лонг: лімітна ціна = тригерна ціна × (1 - відсоток)
  2. Ордери в шорт: лімітна ціна = тригерна ціна × (1 + відсоток)


  1. TP/SL: ордер TP/SL буде розміщено разом із виконанням ордера на вхід (ордер на вихід не підтримується). Обсяги тейк-профіту та стоп-лосу базуються на розмірі кожного сигналу. Ціни TP (тейк-профіт) і SL (стоп-лос) розраховуються на основі тригерної ціни отриманого сигналу.
  2. Для ордерів в лонг:
  3. TP = тригерна ціна × (1 + зміна ціни у %)
  4. SL = тригерна ціна × (1 - зміна ціни у %)
  5. Для ордерів в шорт:
  6. TP = тригерна ціна × (1 - зміна ціни у %)
  7. SL = тригерна ціна × (1 + зміна ціни у %)






Крок 7. Натисніть Запустити вебхук.




Ви успішно створили сигнальну торгівлю! Ви отримуватимете push-сповіщення у застосунку Bybit або браузері про сигнал для вашої стратегії.








Переглянути деталі про сигнал

Щоб переглянути конкретні деталі про сигнал вебхука, перейдіть на вкладку Інструменти, а потім виберіть Вебхук. Тут ви можете переглянути назву сигналу, час активації / час торгівлі, реалізований P&L і час створення.




Щоб переглянути докладні відомості про сигнал, натисніть кнопку Деталі поруч, і ви зможете переглянути URL-адресу та шаблон повідомлення вебхука. Крім того, ви зможете побачити угоду, виконану за допомогою цієї стратегії.




Зверніть увагу, що реалізований P&L, відображений на вкладці «Стратегія вебхука», є реалізованим P&L для угод, виконаних відповідною стратегією вебхука. Будь-який P&L, отриманий від ручної торгівлі, здійсненої користувачами, тут не відображається.



Крім того, ви можете перейти в Історію інструментів → Тип інструментів і вибрати Вебхук, щоб переглянути деталі.









Припинення сигналу вебхука

Припинення або призупинення вручну. Щоб вручну зупинити сигнал вебхука, перейдіть на вкладку Інструменти. Знайдіть сигнал, ініційований за допомогою вебхука, який ви хочете закрити, і натисніть Припинити. Якщо ви хочете призупинити стратегію, натисніть Пауза.





Автоматичне припинення. Сигнал вебхука може бути автоматично припинений з кількох причин:

  1. Стратегію буде припинено, якщо відбудеться 10 послідовних невдалих спроб виконання ордера.
  2. Якщо обраний тип контракту не підтримується в TradingView.
  3. До автоматичного припинення може призвести неповний набір параметрів.
  4. Якщо вибрано непідтримуваний режим позиції (режим хеджування).
  5. Якщо вибраний ф’ючерсний контракт наближається до дати поставки.
  6. Ви досягли максимальної кількості стратегій вебхука, які можна створити. Кожен символ може мати 5 стратегій вебхука, які працюють одночасно, тоді як кожен UID може мати максимум 30 стратегій вебхука, які працюють одночасно.
  7. Щодо вашого акаунта запроваджено обмеження.








Обмеження ордерів

Зверніть увагу, що на ордер, розміщений через стратегію вебхука, розповсюджуються всі обмеження торгівлі вручну на безстрокових та ф’ючерсних контрактах, зокрема обмеження щодо мінімального або максимального розміру ордера, обмеження цін контрактів та інше.


Ваш ордер може не бути розміщено через стратегію вебхука з таких причин:


Повідомлення про помилку

Пояснення

Ордер не вдалося виконати через затримку сигналу.

Передаваний сигнал затримується, і він може відхилятися від вашої стратегії, якщо ордер розміщується та виконується. Тому ордер скасовується.

Не вдалося виконати ордер через невірний символ.

Торгова пара, вказана у стратегії, не підтримується або виключена з лістингу на Bybit.

Не вдалося виконати ордер через відсутність параметрів. Скопіюйте шаблон повідомлення та використайте його знову.

Неповний набір параметрів, запустіть вебхук ще раз.

Не вдалося виконати ордер через недостатній доступний баланс.

У вас недостатньо маржі для розміщення ордера. Внесіть додаткові кошти на свій єдиний торговий акаунт.

Не вдалося виконати ордер через невідповідність режиму позиції.

Сигнальна торгівля через вебхуки підтримується лише в односторонньому режимі позиції. Режим позиції змінено на режим хеджування, а розміщений ордер не виконано.

Ордер не вдалося виконати через перевищення ліміту ризику.

У разі розміщення ордера ліміт ризику перевищить встановлений поточний ліміт. Ви можете змінити ліміт ризику відповідно до налаштувань торгівлі.

Для контрактів, що наближаються до поставки, можна розміщувати лише ордери скорочення позиції.

Термін дії ф’ючерсного контракту наближається до дати поставки, тому відкритий ордер не може бути розміщено.

Ордер не вдалося виконати через перевищення ліміту суми відкритих позицій.

Ліміт відкритого інтересу буде перевищено, якщо ордер буде розміщено.


Чи змогли ми бути корисними?