Теми
    Як використовувати та налаштовувати сигнальну торгівлю через вебхуки на Bybit
    bybit2023-12-12 09:20:47

     

     

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


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

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

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

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

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

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

     

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



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

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

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

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

    Поширені запитання




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

     

    Крок 1. Перейдіть на сторінку контрактів

     

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

     

    1.png

     

    Крок 2. Створити вебхук

     

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

     

    2.png

    3.png

     

    Крок 3. Налаштування вебхука

     

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

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

     

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

     

    4.png

     

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

     

    Примітки.

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

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



    Крок 4. Запустити вебхук

     

    Створивши вебхук, виконайте такі дії:


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

     

    5.png

     

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

     

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

     

    6.png

     

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

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

     

    Примітки:

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

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

     

    7.png

     

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

     

    8.png

     

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

     

    9.png

    10.png

     

     

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

     

    11.png

    12.png

     

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

     

    13.jpeg

     

     

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



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

     

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

     

    14.jpeg

     

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

     

    15.jpeg

     

     

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


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

     

    16.jpeg

     

     

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

     

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

     

    17.jpeg

     

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

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




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

     

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

     

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

     

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

    Пояснення


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

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


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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

    Триває оновлення акаунта на єдиний торговий акаунт. Розміщення ордера буде відхилено. 

     

     

     

    Поширені запитання

     

    Як я можу змінити кредитне плече або режим маржі?

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



     

    Чи потрібно заповнювати всі параметри "Властивості" в TradingView?

    Наразі для коректного отримання сигналу від Bybit обов'язковим до заповнення є тільки параметр Розмір ордера, що визначає кількість у кожному ордері, що виставляється. Фактична кількість ордерів, які можна виставити, залежить від доступного балансу на вашому рахунку. 

     

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

     

    18.png



    У яких одиницях вимірюється розмір ордера за контрактом у TradingView?

     

    19.png

     

    Для інверсних контрактів 1 контракт дорівнює 1 USD, а для безстрокових контрактів USDT або USDC, таких як BTCUSDT або BTC-PERP, 1 контракт дорівнює 1 BTC. Зверніть увагу, що для інверсних контрактів наразі підтримується тільки розмір ордера в контрактах. Введення розміру ордера в USD або у відсотках від капіталу може призвести до відмови в розміщенні ордера. Це пов'язано з відмінностями в логіці розрахунку вартості контракту в TradingView і Bybit.

     

     

     

    Як можна збільшити або зменшити розмір ордера?

    Налаштувати розмір ордера можна в розділі Налаштування стратегії → вікно ВластивостіРозмір ордера. Зверніть увагу, що після зміни розміру ордера необхідно зберегти зміни і в Сповіщеннях.

     

    20.png



     

    Як зберегти зміни в стратегії в Сповіщеннях?

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


    Щоб оновити зміни, перейдіть до Сповіщень, розташованих у правій частині сторінки TradingView, і натисніть на значок Налаштування для редагування сповіщення. Виберіть найактуальніші зміни в Сповіщенні зі списку Умов, що випадає, і натисніть на кнопку Зберегти.

     

    21.png

     

    22.png



    Чи можу я змінити шаблон повідомлення вебхука?

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

     

     

     

    Чому у мене спрацьовує вебхук сигнал, але не відображається історія торгівлі?

     

    23.png

     

    Найімовірніше, це пов'язано з відсутністю або некоректністю налаштувань властивостей вашої стратегії в TradingView, наприклад, невідповідністю введеного розміру ордера вимозі мінімального розміру ордера або некоректним копіюванням шаблону повідомлення. 

     

    Для перевірки деталей перейдіть на портал Оголошення в правому нижньому кутку і натисніть на Сповіщення від TradingView.

     

    24.png



    Як перевірити статус мого ордера?

    Щоб перевірити статус ордера, перейдіть у розділ Відомості про сигнал. Якщо ордер не був виконаний, можна підвести курсор до значка Інфо, щоб дізнатися причину.

     

    25.png



    Як додати додаткову маржу в позицію або увімкнути функцію автоматичного додавання маржі (АДМ)?

    Як і при ручній торгівлі, ви можете додати більше маржі або увімкнути АДМ у вкладці Позиції.

     

    26.png



    Які типи ордерів підтримуються в сигнальній торгівлі через вебхуки?

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

     

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

     

    Інтеграція з Bybit: Щоб виконувати лімітні ордери через TradingView, необхідно інтегрувати TradingView з Bybit через API. Це потребуватиме встановлення необхідних з'єднань і конфігурацій між TradingView і Bybit.

     

    Обмеження Вебхуків: вебхуки зазвичай використовуються для одностороннього зв'язку, коли TradingView надсилає дані в зовнішню систему. Розміщення ордерів вимагає двостороннього зв'язку, коли торгова платформа підтверджує розміщення ордера і забезпечує зворотний зв'язок або оновлення статусу. Веб-хуки самі по собі не можуть забезпечити двонаправлений зв'язок, необхідний для розміщення ордерів.

     

     

     

    Я бачу, що мій Реалізований P&L у деталях веб-хук сигналів плюсовий, чому ж я отримую негативний Реалізований P&L?

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




    Як увімкнути/вимкнути повідомлення про виконання ордера через сигнальну торгівлю з вебхуками?

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



     

     

    27.png 27.5.png

     

     

     

    У додатку для ввімкнення або вимкнення сповіщень TradingView перейдіть у налаштування центру сповіщень.

     

    28.png



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