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

Ранбуки

Повний чекліст готовності деску та сертифікаційні тести інтеграції.

Чекліст готовності деску​

Перед запуском у продакшн перевірте:

Підключення до API​

  • Стейджинг-ендпоінти протестовано
  • Продакшн-ендпоінти налаштовано (за наявності)
  • Ендпоінт перевірки стану (health check) відповідає
  • WebSocket-з'єднання стабільне

Автентифікація​

  • Підписання EIP-712 працює
  • Авторизацію агента налаштовано (якщо застосовно)
  • Керування nonce реалізовано
  • Перевірку підпису протестовано

Система котирування​

  • Масове розміщення ордерів протестовано
  • Звірку життєвого циклу ордерів перевірено
  • Відстеження виконань реалізовано
  • Функціонал скасування протестовано

Контроль ризиків​

  • MMP налаштовано та протестовано
  • Модель маржі зрозуміла
  • Обмеження за тірами перевірено
  • Моніторинг портфеля реалізовано

Моніторинг​

  • Підписки на WebSocket-фіди оформлено
  • Звірку ордерів/виконань автоматизовано
  • Перевірки стану налаштовано
  • Сповіщення налаштовано

Аварійний вимикач (Kill Switch)​

  • Можливість скасувати всі ордери
  • Можливість негайно відключитися
  • Аварійні процедури задокументовано

Хеджування​

  • Інтеграцію з перпами Hyperliquid перевірено
  • Стратегію дельта-хеджування реалізовано
  • Розрахунок маржі перпів зрозумілий

Розрахунок​

  • Обробку експірації протестовано
  • Розрахунок позицій перевірено
  • Джерело референсної ціни зрозуміле

Сертифікаційні тести інтеграції​

Тест 1: Розміщення ордера​

Кроки:

  1. Розмістіть один ордер через POST /order
  2. Перевірте статус ордера: ACKED → OPEN
  3. Переконайтеся, що ордер з'являється в GET /orders?wallet=...
  4. Перевірте отримання WebSocket-повідомлень order_updates

Очікуваний результат: Ордер успішно розміщено, оновлення статусу отримано

Тест 2: Масове розміщення ордерів​

Кроки:

  1. Розмістіть 10 ордерів через POST /bulk_order
  2. Переконайтеся, що всі ордери прийнято
  3. Перевірте статуси ордерів через REST та WS
  4. Переконайтеся у відсутності помилок підпису/автентифікації

Очікуваний результат: Усі ордери успішно розміщено

Тест 3: Відстеження виконань​

Кроки:

  1. Розмістіть ордер, який буде виконано
  2. Слідкуйте за каналом WebSocket fills
  3. Переконайтеся, що виконання отримано з правильним order_id
  4. Перевірте, що виконання з'являється в GET /fills?wallet=...
  5. Переконайтеся, що статус ордера оновлюється на FILLED

Очікуваний результат: Виконання відстежуються коректно, статус ордера оновлено

Тест 4: Відстеження часткових виконань​

Кроки:

  1. Розмістіть ордер, який буде виконано частково
  2. Слідкуйте за каналом WebSocket fills (не order_updates)
  3. Переконайтеся, що часткове виконання отримано
  4. Агрегуйте виконання за order_id для обчислення виконаного обсягу
  5. Переконайтеся, що статус ордера залишається OPEN (не PARTIALLY_FILLED у WS)

Очікуваний результат: Часткові виконання відстежуються через канал fills, статус ордера коректний

Тест 5: Скасування ордера​

Кроки:

  1. Розмістіть ордер через POST /order
  2. Скасуйте ордер через DELETE /order
  3. Перевірте статус ордера: CANCELED
  4. Перевірте отримання WebSocket-повідомлень order_updates

Очікуваний результат: Ордер успішно скасовано, оновлення статусу отримано

Тест 6: Спрацювання MMP​

Кроки:

  1. Налаштуйте MMP через POST /mmp-config
  2. Розмістіть ордери з увімкненим MMP
  3. Спровокуйте спрацювання MMP, перевищивши ліміти
  4. Переконайтеся, що ордери скасовано з причиною MMP
  5. Перевірте, що інші ордери з увімкненим MMP також скасовано

Очікуваний результат: MMP спрацьовує коректно, ордери скасовано

Тест 7: Відхилення через маржу​

Кроки:

  1. Розмістіть ордер, що перевищує маржу
  2. Переконайтеся, що ордер відхилено з причиною "Insufficient margin"
  3. Перевірте, що причина відхилення містить значення необхідної маржі, доступної маржі та дефіциту
  4. Перевірте статус ордера: REJECTED

Очікуваний результат: Ордер відхилено з чіткою причиною

Тест 8: Обмеження за тіром​

Кроки:

  1. Використайте гаманець, налаштований лише на довгі позиції (long-only)
  2. Спробуйте розмістити ордер на продаж без довгої позиції
  3. Переконайтеся, що ордер відхилено з причиною обмеження тіру
  4. Розмістіть ордер на купівлю (має бути успішним)
  5. Розмістіть ордер на продаж для закриття (має бути успішним)

Очікуваний результат: Обмеження за тірами застосовуються коректно

Тест 9: Перепідключення WebSocket​

Кроки:

  1. Підключіться до WebSocket
  2. Підпишіться на канали
  3. Відключіть WebSocket
  4. Перепідключіться з експоненційною затримкою (exponential backoff)
  5. Повторно підпишіться на канали
  6. Опитайте REST, щоб отримати пропущені оновлення

Очікуваний результат: Перепідключення працює, стан відновлено

Тест 10: Звірка портфеля​

Кроки:

  1. Розмістіть ордери та дочекайтеся їх виконання
  2. Перевірте портфель через GET /portfolio?wallet=...
  3. Переконайтеся, що позиції відповідають виконанням
  4. Перевірте коректність використання маржі
  5. Звірте з оновленнями WebSocket portfolio

Очікуваний результат: Стан портфеля точний, звірка успішна

Готовність до продакшну​

Чекліст перед продакшном​

  • Усі інтеграційні тести пройдено
  • Моніторинг і сповіщення налаштовано
  • Аварійний вимикач протестовано
  • Аварійні процедури задокументовано
  • Команду навчено реагуванню на інциденти
  • Контакти підтримки визначено

Чекліст запуску​

  • Стейджинг-середовище повністю протестовано
  • Продакшн-ендпоінти перевірено
  • Дашборди моніторингу готові
  • Сповіщення налаштовано
  • Графік чергувань команди встановлено
  • Документацію переглянуто

Посилання​

  • Швидкий старт: Quickstart
  • Довідник API: REST API
  • Помилки та відхилення: Errors
  • Плейбук інцидентів: Incidents
Останнє оновлення