Цю сторінку перекладено автоматично. Оригінал англійською мовою є канонічним. Читати англійською →
Перейти к основному содержимому

Посібник з інцидентів

Процедури реагування на поширені проблеми.

Проблеми зі з'єднанням​

Розрив WebSocket​

Симптоми: З'єднання WebSocket втрачено, повідомлення не надходять

Дії:

  1. Реалізуйте автоматичне перепідключення з експоненційною затримкою
  2. Опитуйте REST-ендпоінти, щоб надолужити пропущені оновлення
  3. Повторно підпишіться на всі канали після перепідключення

Запобігання: Моніторте статус з'єднання та реалізуйте надійну логіку перепідключення

Тайм-аут API​

Симптоми: REST-запити завершуються тайм-аутом або повертають помилки 5xx

Дії:

  1. Повторюйте запити з експоненційною затримкою
  2. Перевірте ендпоінт стану: GET /health
  3. Зменште частоту запитів, якщо система перевантажена

Запобігання: Реалізуйте обмеження частоти запитів та circuit breakers

Проблеми з ордерами​

Високий рівень відхилень​

Симптоми: Багато ордерів відхиляються

Розслідування:

  1. Перевірте причини відхилення через GET /orders?wallet=...
  2. Перегляньте маржу: GET /portfolio?wallet=...
  3. Перевірте рівень (tier): GET /user-tier?wallet=...
  4. Переконайтеся, що інструменти не мають простроченої експірації: GET /instruments

Дії:

  • Якщо проблеми з маржею: Зменште розмір позиції або додайте забезпечення
  • Якщо проблеми з рівнем: Оновіться до tier2 або покрийте продажі
  • Якщо інструменти прострочені: Використовуйте інші інструменти

Відсутні виконання​

Симптоми: Ордери виконано, але сповіщення про виконання не надходять

Розслідування:

  1. Перевірте виконання через GET /fills?wallet=...
  2. Перевірте підписку на канал WebSocket fills
  3. Перевірте статус з'єднання WebSocket

Дії:

  • Повторно підпишіться на канал fills
  • Опитайте REST-ендпоінт для пропущених виконань
  • Звірте виконання зі статусами ордерів

Застарілий статус ордера​

Симптоми: Статус ордера в REST не збігається з WS

Розслідування:

  1. Перевірте статус з'єднання WebSocket
  2. Переконайтеся, що кеш ордерів актуальний
  3. Порівняйте статуси ордерів у REST та WS

Дії:

  • Опитайте REST після перепідключення WS, щоб надолужити пропущене
  • Використовуйте REST як джерело істини для звірки

Проблеми з MMP​

MMP спрацьовує занадто часто​

Симптоми: Багато ордерів скасовано через MMP

Розслідування:

  1. Перевірте конфігурацію MMP: GET /mmp-config?wallet=...&currency=...
  2. Перегляньте патерни виконань та кумулятивні метрики
  3. Перевірте, чи не занадто низькі ліміти

Дії:

  • Збільште ліміти MMP (qty, дельта, вега)
  • Збільште interval_ms, щоб дозволити більше виконань у вікні
  • Зменште частоту котирування

MMP не спрацьовує​

Симптоми: Виконання перевищують ліміти, але MMP не спрацьовує

Розслідування:

  1. Переконайтеся, що MMP увімкнено: GET /mmp-config?wallet=...&currency=...
  2. Перевірте mmp_enabled=true на ордерах
  3. Переконайтеся, що валюта відповідає базовому активу ордера

Дії:

  • Увімкніть MMP на ордерах: mmp_enabled=true
  • Налаштуйте MMP для правильної валюти
  • За потреби скоригуйте ліміти

Проблеми з маржею​

Недостатня маржа​

Симптоми: Ордери відхиляються з повідомленням "Insufficient margin"

Розслідування:

  1. Перевірте портфель: GET /portfolio?wallet=...
  2. Перегляньте розрахунок маржі
  3. Перевірте, який сценарій не проходить

Дії:

  • Зменште розмір позиції
  • Додайте забезпечення (коли буде реалізовано процес депозиту)
  • Закрийте позиції, щоб вивільнити маржу
  • Хеджуйте експозицію, щоб зменшити збиток у найгіршому сценарії

Відсутня спотова ціна​

Симптоми: Ордери відхиляються з повідомленням "No spot price available"

Розслідування:

  1. Перевірте підключення до фіда спотових цін Hyperliquid
  2. Переконайтеся, що символ базового активу правильний
  3. Перевірте, чи працює фід спотових цін

Дії:

  • Зачекайте на відновлення фіда спотових цін
  • Використовуйте інший базовий актив, якщо доступний
  • Зверніться до підтримки, якщо проблема не зникає

Системні проблеми​

Висока затримка​

Симптоми: Повільні відповіді API або затримки повідомлень WebSocket

Розслідування:

  1. Перевірте навантаження на систему
  2. Моніторте час відповіді
  3. Перевірте мережеве з'єднання

Дії:

  • Зменште частоту запитів
  • Реалізуйте обмеження частоти запитів
  • Зверніться до підтримки, якщо проблема не зникає

Обмеження частоти запитів​

Симптоми: Запити відхиляються або обмежуються

Поточний стан: Обмеження частоти запитів застосовується для кожного гаманця. Див. Ліміти запитів для деталей.

Дії:

  • Перевірте заголовок Retry-After та зачекайте перед повторною спробою
  • Моніторте X-RateLimit-Remaining, щоб уникнути досягнення лімітів
  • За можливості використовуйте bulk-ендпоінти

Аварійні процедури​

Аварійне вимкнення​

Негайні дії:

  1. Скасуйте всі ордери: DELETE /bulk_order або DELETE /bulk_order_cloid
  2. Відключіть WebSocket
  3. Зупиніть систему котирування

Відновлення:

  1. Переконайтеся, що всі ордери скасовано: GET /orders?wallet=...
  2. Перегляньте портфель: GET /portfolio?wallet=...
  3. Розслідуйте першопричину
  4. Відновіть котирування після вирішення проблеми

Звірка даних​

Після інциденту:

  1. Опитайте REST-ендпоінти для поточного стану
  2. Звірте ордери: GET /orders?wallet=...
  3. Звірте виконання: GET /fills?wallet=...
  4. Звірте портфель: GET /portfolio?wallet=...
  5. Відновіть підписки WebSocket

Ескалація​

Якщо проблема не зникає:

  1. Перегляньте відомі проблеми та повідомлення стейджинг-середовища, надані разом із доступом
  2. Перегляньте Ранбуки для детальних процедур
  3. Зверніться до підтримки, надавши:
    • Адресу гаманця
    • Повідомлення про помилки
    • Мітки часу
    • Кроки для відтворення
Останнє оновлення