Liquidation

Die Liquidation schützt das System vor Konten, die ihre Margin-Verpflichtungen nicht mehr erfüllen können. Fällt das Eigenkapital eines Kontos unter seine Maintenance-Margin-Anforderung, versucht Hypercall zunächst, das Konto durch das Schließen von Short-Optionen zu sanieren. Gelingt das nicht rechtzeitig, eskaliert das Konto zur vollständigen Liquidation.

Auslösebedingungen

Die Liquidation wird ausgelöst, wenn ein Konto unterdeckt ist:

Portfolio Margin:

$$\text{Eigenkapital} < \text{Erforderliche Maintenance Margin}$$

Standard Margin:

$$\text{Cash} < \text{Erforderliche MM}$$

Die SM-Liquidation richtet sich nach dem Cash-Spielraum gegenüber der Maintenance Margin (cash - mm_required), nicht nach dem Eigenkapital. Bewertungen von Long-Optionen, die den NAV erhöhen, verhindern daher keinen Cash-Fehlbetrag. Das API-Feld maintenance_margin = equity - mm_required wird weiterhin ausgegeben, ist aber nicht der Auslöser für die SM-Liquidation. Siehe Standard Margin.

Bei einem Portfolio-Margin-Konto wird das Eigenkapital abzüglich aller Verbindlichkeiten gegenüber dem PM-Lending-Pool berechnet, und die Maintenance-Anforderung berücksichtigt auch die eigene Liquidation Ihrer Perps durch Hyperliquid auf HyperCore. Hyperliquid kann diese Perps weiterhin nach eigenen Regeln liquidieren, unabhängig von Hypercall. Siehe Portfolio Margin.

Hypercall prüft den Zustand jedes Kontos mit Positionen alle 5 Sekunden.

Zustände

Zustand	Was passiert	Orders
Healthy	PM: Eigenkapital mindestens so hoch wie die erforderliche MM. SM: Cash mindestens so hoch wie die erforderliche MM.	Alle Orders erlaubt
PreLiquidation	Teilliquidation: Hypercall platziert schließende Orders auf die Short-Optionen des Kontos	Nur Orders, die eine bestehende Position reduzieren
InLiquidation	Vollständige Liquidation. Standard Margin: Das Buch des Kontos wird einem Liquidator angeboten	Nur Orders, die eine bestehende Position reduzieren
Liquidated	Ein Liquidator hat das Buch des Kontos übernommen	Nur Orders, die eine bestehende Position reduzieren

Auszahlungen und PM-Cash-Sweeps sind in PreLiquidation und InLiquidation deaktiviert. Sobald ein PM-Konto für die vollständige Liquidation abgebaut wird, sind alle seine Orders gesperrt.

Zustandsübergänge

1. Healthy zu PreLiquidation: Das Konto fällt unter seine MM-Schwelle.
2. PreLiquidation zu Healthy: Das Konto erreicht das gepufferte Ziel, erforderliche MM × 1,05, und keine seiner Liquidations-Orders ist mehr offen. Die Grenze ist inklusiv.
3. PreLiquidation zu InLiquidation: Das Konto liegt weiterhin unter dem Ziel, und eine der unten genannten Eskalationsbedingungen ist erfüllt.
4. InLiquidation zu Healthy: Das Konto erholt sich, bevor ein Liquidator es übernimmt, und die vollständige Liquidation wird gestoppt.
5. InLiquidation zu Liquidated: Ein Liquidator übernimmt das Konto.

Teilliquidation

Wenn ein Konto in PreLiquidation eintritt:

1. Orders, die das Risiko erhöhen würden, werden sofort abgelehnt. Orders, die eine bestehende Position reduzieren, werden weiterhin angenommen.
2. Hypercall storniert Ihre offenen risikoerhöhenden Orders und platziert Reduce-only-Kauforders auf Ihre Short-Optionen, so bemessen, dass das Konto wieder auf erforderliche MM × 1,05 kommt. Zuerst werden die Shorts geschlossen, die pro Kontrakt die meiste Margin freisetzen.
3. Jede Order wird zum besten Ask (oder Mid bzw. Bid, falls kein Ask vorhanden ist) zuzüglich eines Liquidationsbonus bepreist. Der Bonus beginnt bei 0,5 % und steigt über 5 Minuten linear auf 10 %. Die Orders werden alle 5 Sekunden neu bepreist.
4. Sobald das Konto wieder mindestens auf dem Ziel liegt und die Liquidations-Orders verschwunden sind, kehrt es in den Zustand Healthy zurück.

Der Bonus ist ein Kostenfaktor für Sie: Es ist der Betrag, den Sie über dem Markt zahlen, damit Ihre Shorts schnell geschlossen werden.

Nutzen Sie dieses Zeitfenster, um das Konto selbst zu sanieren:

• Sicherheiten einzahlen
• Positionen schließen, insbesondere Short-Optionen
• Risikoerhöhende Orders stornieren

Eskalation zur vollständigen Liquidation

Ein Konto in PreLiquidation, das weiterhin unter dem Ziel liegt, eskaliert zur vollständigen Liquidation, sobald eine der folgenden Bedingungen zutrifft:

• Das Eigenkapital ist negativ.
• Es sind keine Short-Optionen mehr vorhanden, die die Teilliquidation schließen könnte.
• Die Eskalationsfrist ist abgelaufen. Die Frist endet 20 Minuten nach dem Eintritt des Kontos in PreLiquidation.

Das 20-Minuten-Fenster sorgt außerdem dafür, dass eine kurzzeitige Fehlbewertung ein Konto nicht direkt in die vollständige Liquidation treibt.

Vollständige Liquidation

Bei einem Standard-Margin-Konto übergibt die vollständige Liquidation das Buch des Kontos an einen Liquidator innerhalb der Hypercall-Engine. Hypercall storniert zunächst alle offenen Orders des Kontos und bietet das Konto dann an.

• Der Liquidator muss das Konto wieder auf erforderliche MM × 1,05 bringen und stellt daher die fehlende Margin bereit.
• Hat das Konto noch positives Eigenkapital, zahlt der Liquidator Ihnen dieses Eigenkapital aus.
• Der Liquidator übernimmt sämtliche Positionen und das Cash des Kontos.

Erholt sich das Konto, bevor ein Liquidator es übernimmt, wird die vollständige Liquidation gestoppt und das Konto kehrt in den Zustand Healthy zurück.

Bei einem Portfolio-Margin-Konto ist die oben beschriebene Teilliquidation der Schritt, auf den Sie sich einstellen sollten. Sobald ein PM-Konto eskaliert, werden seine offenen Orders storniert und seine Orders gesperrt, während es abgewickelt wird. Diese Seite wird den Rest dieses Schritts beschreiben, sobald er endgültig feststeht.

Verluste über das Eigenkapital hinaus

Ein Verlust über das Eigenkapital eines Kontos hinaus wird nie gedeckt, indem Positionen anderer Trader geschlossen werden; Hypercall hat kein Auto-Deleveraging. Wer ihn trägt, hängt vom Margin-Modus ab.

Standard Margin. Der Liquidator übernimmt die Positionen und das Barguthaben des Kontos im aktuellen Zustand, einschließlich eines Fehlbetrags. Ein Fehlbetrag bei negativem Eigenkapital bleibt beim Liquidator.

Portfolio Margin. Was das Konto nach der Liquidation noch schuldet (Pool-Kredite und unbezahltes Settlement), durchläuft einen festen Wasserfall:

1. Die Sicherheiten des Kreditnehmers. Hypercall zieht aus den HyperCore-Sicherheiten des Kontos ein. Siehe Einziehung. Ein Kredit wird erst abgeschrieben, wenn die Einziehung ausgeschöpft ist.
2. Die First-Loss-Reserve. Sie bezahlt zuerst die Konten, denen der Kreditnehmer noch Settlement schuldet, älteste Batch zuerst, und deckt dann den abgeschriebenen Kredit.
3. Kreditgeber des Pools. Was die Reserve nicht decken kann, senkt den Anteilspreis des Pools.

Die Schuld wird nicht erlassen. Was später vom Kreditnehmer eingezogen wird, bezahlt zuerst noch offene Settlement-Gegenparteien, älteste Charge zuerst, dann einen noch offenen Pool-Kredit; erst der Rest geht an die Reserve und die Kreditgeber, im Verhältnis zu ihrem jeweiligen Verlust. Die First-Loss-Reserve sichert nur PM-Kredite ab; einen venueweiten Versicherungsfonds gibt es nicht.

API-Endpunkte

Liquidationsstatus abrufen

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

data ist null für ein Konto, das den Zustand Healthy nie verlassen hat.

Antwort:

{
  "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 listet außerdem die IDs der offenen Liquidations-Orders auf. full_liquidation enthält die Übernahmedetails, einschließlich margin_needed, winner und des aktuell erforderlichen Gebots.

Liquidationshistorie abrufen

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

Gibt die Historie der Zustandsübergänge eines Kontos zurück.

Öffentliche Liquidationshistorie abrufen

GET /liquidations?limit=50

Gibt die Historie der Liquidationsübergänge über alle Wallets hinweg zurück, die neuesten zuerst. Der Endpunkt ist öffentlich und verwendet Cursor-Paginierung für Liquidator-Bots und Monitoring-Tools.

Query-Parameter

• cursor: Opaker Cursor, der von der vorherigen Seite zurückgegeben wurde.
• limit: Seitengröße, Standard 50, Maximum 100.
• wallet: Optionaler Wallet-Filter.
• status oder state: Optionaler Filter für den Zustand des Liquidationsübergangs. Zulässige Werte sind healthy, pre_liquidation, in_liquidation und liquidated.
• margin_mode: Optionaler Filter für den Margin-Modus. Zulässige Werte sind standard und portfolio.
• liquidation_mode: Optionaler Filter für den Liquidationsmodus. Zulässige Werte sind partial und full.

Antwort: PublicLiquidationsResponse mit Einträgen zu Liquidationsübergängen und page.next_cursor für die nächste Anfrage.

Auktionsdetails abrufen

GET /liquidation/auction/{auction_id}

Gibt Status, Positionen und Settlement-Details der vollständigen Liquidation zurück.

WebSocket-Benachrichtigungen

Änderungen des Liquidationszustands werden über den Kanal liquidation übertragen:

{
  "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 und full_liquidation enthalten dieselben Felder wie der Status-Endpunkt. Abonnieren Sie den Kanal, um Echtzeit-Updates für Ihre Wallet zu erhalten.

Parameter

Parameter	Wert	Beschreibung
Intervall der Zustandsprüfung	5 Sekunden	Wie oft der Kontozustand geprüft wird
Erholungsziel	Erforderliche MM × 1,05	Eigenkapital (PM) bzw. Cash (SM), das für die Rückkehr zu Healthy nötig ist, und das Niveau, das eine vollständige Liquidation wiederherstellt
Mindestfehlbetrag	0	Jeder Fehlbetrag startet die Teilliquidation
Liquidationsbonus	0,5 %, steigend auf 10 % über 5 Minuten	Aufschlag auf den Referenzpreis bei Orders der Teilliquidation
Intervall der Neubepreisung	5 Sekunden	Wie oft Orders der Teilliquidation neu bepreist werden
Eskalationsfrist	20 Minuten	Zeit in PreLiquidation, bevor die vollständige Liquidation beginnt

Best Practices

Für Trader

1. Margin-Quote überwachen: Halten Sie das Eigenkapital deutlich über der MM (empfohlen ist ein Puffer von 2x)
2. Alerts einrichten: Nutzen Sie den WebSocket, um eine PreLiquidation frühzeitig zu erkennen
3. Reserven vorhalten: Halten Sie zusätzliche Sicherheiten zur Einzahlung bereit
4. Shorts selbst schließen: Auf Orders, die Sie selbst platzieren, zahlen Sie keinen Liquidationsbonus

Zustand abfragen

Prüfen Sie Ihren Margin-Status regelmäßig:

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)

---

Siehe auch:

• Portfolio Margin: MM-Berechnung für Portfolio-Konten
• Standard Margin: MM-Berechnung für Standard-Konten
• Margin Floor: Sicherheitsuntergrenzen, die die Liquidationsschwelle beeinflussen
• PM-Finanzierung: wie PM-Schulden eingezogen werden
• PM-Risikoparameter: die MM-Quote und alle weiteren geltenden PM-Einstellungen
• PM-Risiko simulieren: MM-Spielraum für ein hypothetisches Buch prüfen