Теми
    Як використовувати та налаштовувати сигнальну торгівлю через вебхуки на Bybit
    bybit2025-07-10 13:46:43
    Покрокова ІнструкціяЧасті запитання

    Дисклеймер. Ця стаття є попереднім перекладом на українську за допомогою машинного перекладу. Покращена версія буде доступна пізніше.

     

     

     

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

     

     

     

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

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

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

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

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

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




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

     

     





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

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

     






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

     






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

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

     

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

     

     

    Примітки.

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

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



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








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

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

     






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

     

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

     






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

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

     

    Примітки:

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

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

     

     

     

     

     

     

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

     

    Параметр

    Цінності

    Опис

    символ

    {{ticker}} з TradingView

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

    сторона

    • {{strategy.order.action}} з TradingView

    • ENTER_LONG

    • ВИХІД_ЛОНГ

    • ENTER_SHORT

    • ВИХІД_КОРОТКИЙ

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

     

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

     

    trigger_time

    {{timenow}} з TradingView

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

    Стратегія_id

    Створено Bybit після спрацювання сигналу

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

    сума_тип

    • Абсолютна кількість

    • позиція.відсоток

    • Ви можете вибрати тип суми на сторінці налаштувань вебхука або редагувати значення параметра безпосередньо з шаблону, вставленого в Tradingview.

    • Тип суми опціональний і за замовчуванням дорівнює абсолютному значенню (значення = абсолютне, кількість).

    • Абсолютне значення означає, що вебхук розмістить ваш ордер на основі налаштованої кількості.

    • Вибір позиції % (значення=позиціон.відсоток) доступний лише для ордера на вихід. Він закриває вашу позицію на основі вибраного відсотка відкритої позиції.

     

    кількість

    • strategy.order.contracts

    • Кількість контракту

    • відсоток позиції

    • Якщо встановлена кількість {{strategy.order.contracts}}, Webhook розмістить ваш ордер на основі налаштувань у Tradingview.

    • Ви також можете ввести певну кількість на самому шаблоні, і це замінить початковий сигнал. Візьмімо для прикладу BTC, якщо ви встановили «кількість»: «1». Для контрактів USDT/USDC 1 контракт дорівнює 1 BTC. Для інверсного контракту 1 контракт дорівнює 1 USD.

    • Якщо вибраний вами тип суми — відсоток позиції, задана кількість — це відсоток позиції, яку ви хочете закрити, коливається в діапазоні [0,01, 100] у %. Відсоток закриття завжди залежить від розміру позиції за тригером.

    ціна

    Торгівля за ціною

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

    max_lag

    Ненегативне ціле значення між [5, 300].

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

     

     

     

     

     

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

     

     

    Примітки.

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

     

     

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

     

     

     

     

     

     

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

    • Тип ордера: Ви можете встановити ринковий або лімітний ордер. Після спрацювання сповіщення буде розміщено відповідний ордер. Для лімітних ордерів потрібно встановити відстань, щоб активувати її як ціну лімітного ордера.

      • Довгий: Лімітна ціна = ціна сигнального тригера × (1 - відстань до спрацювання)

      • Короткий: Лімітна ціна = ціна сигнального тригера × (1 + відстань для спрацювання)

    • TP/SL: Ордер TP/SL буде розміщено після виконання ордера на вхід (ордер на вихід не підтримується). Кількість тейк-профіту та стоп-лосу залежить від розміру кожного сигналу. Ви можете встановити або TP, або SL, і після розміщення ордера ви можете змінити ціну відповідно до ваших уподобань на вкладці позиції. Їхні ціни обчислюються на основі ціни входу цього сигналу.

      • Ціна тригера довгого TP: Ціна входу сигналу × (1 + зміна ціни %)

      • Коротка тригерна ціна TP: Ціна входу сигналу × (1 - зміна ціни %)

      • Тригерна ціна довгої SL: Ціна входу сигналу × (1 - зміна ціни %)

      • Коротка тригерна ціна 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.

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

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

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

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

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

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

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

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

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

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

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

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

    Чи змогли ми бути корисними?
    yesТакyesНі