Ліквідація

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

Умови запуску

Ліквідація запускається, коли акаунт стає збитковим (underwater):

Портфельна маржа:

$$\text{Капітал} < \text{Необхідна підтримуюча маржа}$$

Стандартна маржа:

$$\text{Готівка} < \text{Необхідна MM}$$

Ліквідацію в SM визначає запас готівки понад підтримуючу маржу (cash - mm_required), а не капітал, тож оцінки довгих опціонів, які підвищують NAV, не запобігають нестачі готівки. Поле API maintenance_margin = equity - mm_required і далі повертається, але не є тригером ліквідації в SM. Див. Стандартна маржа.

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

Hypercall перевіряє стан кожного акаунта з позиціями кожні 5 секунд.

Стани

Стан	Що відбувається	Заявки
Healthy	PM: капітал на рівні необхідної MM або вище. SM: готівка на рівні необхідної MM або вище.	Дозволені всі заявки
PreLiquidation	Часткова ліквідація: Hypercall виставляє закривальні заявки на короткі опціони акаунта	Лише заявки, що зменшують наявну позицію
InLiquidation	Повна ліквідація. Стандартна маржа: книгу позицій акаунта пропонують ліквідатору	Лише заявки, що зменшують наявну позицію
Liquidated	Ліквідатор перебрав книгу позицій акаунта	Лише заявки, що зменшують наявну позицію

Виведення коштів і переказ готівки PM вимкнені в станах PreLiquidation та InLiquidation. Щойно акаунт PM починають розпродавати для повної ліквідації, усі його заявки блокуються.

Переходи між станами

1. Healthy → PreLiquidation: акаунт опускається нижче свого порогу MM.
2. PreLiquidation → Healthy: акаунт досягає цільового рівня з буфером, необхідна MM × 1.05, і жодна з його ліквідаційних заявок більше не відкрита. Межа включна.
3. PreLiquidation → InLiquidation: акаунт досі нижче цільового рівня, і виконано одну з умов ескалації, наведених нижче.
4. InLiquidation → Healthy: акаунт відновлюється до того, як його перебере ліквідатор, і повна ліквідація зупиняється.
5. InLiquidation → Liquidated: ліквідатор перебирає акаунт.

Часткова ліквідація

Коли акаунт переходить у стан PreLiquidation:

1. Заявки, що додають ризик, одразу відхиляються. Заявки, що зменшують наявну позицію, і далі приймаються.
2. Hypercall скасовує ваші відкриті заявки, що додають ризик, і виставляє заявки на купівлю лише для зменшення позиції (reduce-only) на ваші короткі опціони в обсязі, достатньому, щоб повернути акаунт до рівня необхідна MM × 1.05. Спершу закриваються ті шорти, що вивільняють найбільше маржі на контракт.
3. Кожна заявка оцінюється за найкращим аском (або за серединою чи бідом, якщо аску немає) плюс ліквідаційний бонус. Бонус починається з 0.5% і лінійно зростає до 10% протягом 5 хвилин. Ціни заявок оновлюються кожні 5 секунд.
4. Щойно акаунт повертається на цільовий рівень або вище і ліквідаційних заявок більше немає, він повертається в стан Healthy.

Бонус є вашим витратами: це те, що ви платите понад ринкову ціну, щоб ваші шорти швидко закрилися.

Використайте це вікно, щоб виправити акаунт самостійно:

• Внесіть заставу
• Закрийте позиції, особливо короткі опціони
• Скасуйте заявки, що додають ризик

Ескалація до повної ліквідації

Акаунт у стані PreLiquidation, який досі нижче цільового рівня, переходить до повної ліквідації, якщо виконується будь-яка з умов:

• Капітал від'ємний.
• Не залишилося коротких опціонів, які могла б закрити часткова ліквідація.
• Минув дедлайн ескалації. Дедлайн настає через 20 хвилин після переходу акаунта в стан PreLiquidation.

20-хвилинне вікно також означає, що короткочасна хибна оцінка не відправляє акаунт одразу в повну ліквідацію.

Повна ліквідація

Для акаунта зі стандартною маржею повна ліквідація передає книгу позицій акаунта ліквідатору всередині рушія Hypercall. Hypercall спершу скасовує всі відкриті заявки акаунта, а потім пропонує акаунт.

• Ліквідатор має повернути акаунт до рівня необхідна MM × 1.05, тож він вносить маржу, якої бракує акаунту.
• Якщо акаунт досі має додатний капітал, ліквідатор виплачує цей капітал вам.
• Ліквідатор отримує всі позиції та готівку акаунта.

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

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

Збитки понад капітал

Збиток понад капітал акаунта ніколи не покривається закриттям позицій інших трейдерів: автоматичного зменшення кредитного плеча (auto-deleveraging) на Hypercall немає. Хто несе збиток, залежить від режиму маржі.

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

Портфельна маржа. Те, що акаунт усе ще винен після ліквідації (позики пулу та неоплачені розрахунки на експірації), проходить фіксований каскад:

1. Забезпечення позичальника. Hypercall стягує борг із забезпечення акаунта на HyperCore. Дивіться стягнення. Позику списують лише після того, як стягнення вичерпано.
2. Резерв першого збитку. Спершу він платить акаунтам, яким позичальник досі винен за розрахунками, починаючи з найстаршого пакета, потім покриває списану позику.
3. Кредитори пулу. Усе, що резерв не покриває, знижує ціну частки пулу.

Борг не прощається. Усе, що пізніше вдається стягнути з позичальника, спершу йде контрагентам за settlement, яким він ще винен, починаючи з найстарішого пакета, потім на погашення непогашеної позики пулу; лише залишок повертається резерву та кредиторам пропорційно до їхніх втрат. Резерв першого збитку покриває лише позики PM; загального страхового фонду майданчика немає.

Ендпоінти API

Отримати статус ліквідації

GET /liquidation/status?wallet=0x...

data має значення null для акаунта, який ніколи не виходив зі стану Healthy.

Відповідь:

{
  "success": true,
  "data": {
    "wallet": "0x...",
    "state": "pre_liquidation",
    "liquidation_mode": "partial",
    "margin_mode": "portfolio",
    "equity": "4500.00",
    "mm_required": "5000.00",
    "maintenance_margin": "-500.00",
    "shortfall": "500.00",
    "partial_liquidation": {
      "entered_at": 1737312000000,
      "target_equity": "5250.00",
      "mm_shortfall": "500.00",
      "escalation_deadline": 1737313200000,
      "bonus_bps": 50
    },
    "full_liquidation": null
  }
}

partial_liquidation також містить ідентифікатори відкритих ліквідаційних заявок. full_liquidation містить деталі перебирання, зокрема margin_needed, winner і поточну необхідну ставку.

Отримати історію ліквідацій

GET /liquidation/history?wallet=0x...&limit=20

Повертає історію переходів між станами для акаунта.

Отримати публічну історію ліквідацій

GET /liquidations?limit=50

Повертає історію ліквідаційних переходів за всіма гаманцями, від найновіших. Ендпоінт публічний і використовує курсорну пагінацію для ботів-ліквідаторів та інструментів моніторингу.

Параметри запиту

• cursor: непрозорий курсор, повернений попередньою сторінкою.
• limit: розмір сторінки, за замовчуванням 50, максимум 100.
• wallet: необов'язковий фільтр за гаманцем.
• status або state: необов'язковий фільтр за станом ліквідаційного переходу. Допустимі значення: healthy, pre_liquidation, in_liquidation і liquidated.
• margin_mode: необов'язковий фільтр за режимом маржі. Допустимі значення: standard і portfolio.
• liquidation_mode: необов'язковий фільтр за режимом ліквідації. Допустимі значення: partial і full.

Відповідь: PublicLiquidationsResponse із записами ліквідаційних переходів і page.next_cursor для наступного запиту.

Отримати деталі аукціону

GET /liquidation/auction/{auction_id}

Повертає статус повної ліквідації, позиції та деталі розрахунку.

Сповіщення WebSocket

Зміни стану ліквідації транслюються в каналі liquidation:

{
  "type": "LiquidationStateChange",
  "wallet_address": "0x...",
  "previous_state": "healthy",
  "new_state": "pre_liquidation",
  "liquidation_mode": "partial",
  "margin_mode": "portfolio",
  "equity": "4500.00",
  "mm_required": "5000.00",
  "maintenance_margin": "-500.00",
  "shortfall": "500.00",
  "partial_liquidation": { "escalation_deadline": 1737313200000, "bonus_bps": 50 },
  "full_liquidation": null,
  "timestamp": 1737312000000
}

partial_liquidation і full_liquidation містять ті самі поля, що й ендпоінт статусу. Підпишіться, щоб отримувати оновлення для вашого гаманця в реальному часі.

Параметри

Параметр	Значення	Опис
Інтервал перевірки стану	5 секунд	Як часто перевіряється стан акаунта
Цільовий рівень відновлення	Необхідна MM × 1.05	Капітал (PM) або готівка (SM), потрібні для повернення в стан Healthy, а також рівень, який відновлює повна ліквідація
Мінімальна нестача	0	Будь-яка нестача запускає часткову ліквідацію
Ліквідаційний бонус	Від 0.5% зі зростанням до 10% протягом 5 хвилин	Надбавка до референсної ціни в заявках часткової ліквідації
Інтервал оновлення цін	5 секунд	Як часто оновлюються ціни заявок часткової ліквідації
Дедлайн ескалації	20 хвилин	Час у стані PreLiquidation до початку повної ліквідації

Найкращі практики

Для трейдерів

1. Стежте за коефіцієнтом маржі: тримайте капітал значно вище MM (рекомендовано двократний буфер)
2. Налаштуйте сповіщення: використовуйте WebSocket, щоб завчасно виявити передліквідаційний стан
3. Майте резерв: тримайте вільну заставу напоготові для внесення
4. Закривайте шорти самостійно: за заявки, які ви виставляєте самі, ліквідаційний бонус не сплачується

Перевірка стану

Регулярно перевіряйте стан своєї маржі:

curl "https://api.hypercall.xyz/portfolio?wallet=0x..."

# Look for:
# - span_margin.equity vs span_margin.maintenance_margin_required (portfolio)
# - margin_summary.standard_margin.maintenance_margin_headroom (standard)

---

Див. також:

• Портфельна маржа: розрахунок MM для портфельних акаунтів
• Стандартна маржа: розрахунок MM для стандартних акаунтів
• Мінімальний рівень маржі: захисні мінімуми, що впливають на поріг ліквідації
• Фінансування PM: як стягується борг PM
• Параметри ризику PM: коефіцієнт MM і всі інші чинні налаштування PM
• Симуляція ризику PM: перевірка запасу MM для гіпотетичної книги позицій