Ця стаття містить прямі посилання на офіційну технічну документацію для розробників щодо налаштування торгівлі через WebSocket на WhiteBIT.
Робота з ордерами через WebSocket
Функція «WebSocket Trading» забезпечує пряме керування ордерами через WhiteBIT API, що спрощує процеси подієвої торгівлі та знижує затримку під час розміщення або скасування ордерів за рахунок скорочення кількості проміжних етапів.
Під час створення нової інтеграції або оновлення наявної торгової системи всі актуальні методи, технічні вимоги та приклади наведено в розділі «WebSocket Trading» у публічній документації API WhiteBIT.
Цей розділ містить детальні відомості про:
підтримувані операції та параметри
автентифікацію та безпеку з’єднання
ліміти запитів («rate limits»)
обробку статусів і виконання ордерів
Практичний приклад використання
Нижче наведено приклад того, як автоматизована система може виконувати швидке коригування ордерів за допомогою одного постійного WebSocket-з’єднання замість надсилання кількох REST-запитів.
Цикл скасування та заміни
Уявіть торгову систему, яка одночасно розміщує ордери на купівлю та продаж. Коли ціна або ринкові умови змінюються, система перевіряє актуальність своїх відкритих ордерів. Якщо вони більше не відповідають стратегії, вона оновлює їх через одне з’єднання:
- Система отримує оновлення книги ордерів (order book) у реальному часі через відкритий WebSocket-канал.
- Торговий алгоритм обробляє дані та розраховує нові параметри для ордерів.
- Система надсилає інструкцію зі скасуванням застарілого активного ордера.
- Система надсилає інструкцію на розміщення нового ордера з оновленими параметрами.
Такий процес мінімізує час, протягом якого неактуальний ордер залишається активним у книзі ордерів, що допомагає захистити капітал від несприятливих рухів ціни.
Ринкові дані для відстеження
Торгова система може відстежувати специфічні ринкові змінні в реальному часі залежно від обраного типу ринку.
Для безстрокових ф’ючерсів (PERP)
- Index Price (Індексна ціна) — агрегована референтна ціна базового активу на провідних біржах.
- Mark Price (Ціна маркування) — розрахункова ціна, яка використовується для оцінки позицій, розрахунку нереалізованого PnL та запуску ліквідацій.
- Funding Rate (Ставка фінансування) — періодична комісія, якою обмінюються власники довгих та коротких позицій.
- PnL (Прибуток та збиток) — поточний реалізований або нереалізований фінансовий результат активних позицій.
Для спотової торгівлі
- Остання ціна угоди — ціна виконання останньої транзакції на біржі.
- Котирування в книзі ордерів — найкращі доступні ціни купівлі (bid) та продажу (ask) на ринку.
- Обсяг торгівлі — загальний обсяг активу, проторгований за визначений період.