Onboarding für Portfolio Margin

Portfolio Margin (PM) ist in Produktion live und steht allen Konten offen. PM berechnet die Margin für Ihre Optionen und Ihre Hyperliquid-Perps gemeinsam anhand des Worst-Case-Portfoliorisikos. Ein abgesichertes Buch benötigt daher deutlich weniger Sicherheiten als unter Standard Margin. Diese Seite beschreibt, wie Sie zu PM wechseln. Wie die Margin selbst berechnet wird, erfahren Sie unter Portfolio Margin.

Kurz gesagt: Verwenden Sie eine neue Manager-Wallet, erstellen Sie dafür ein Hypercall-Konto, aktivieren Sie den HyperCore Unified Account Mode, wechseln Sie in den Portfolio-Modus und zahlen Sie erst danach ein.

Warum Sie mit einer neuen Wallet beginnen

Ein Standard-Margin-Konto (SM) mit Guthaben oder offenem Buch kann nicht direkt auf Portfolio Margin umgestellt werden. Hypercall akzeptiert einen Wechsel in den Portfolio-Modus nur, wenn für die Manager-Wallet alle folgenden Bedingungen erfüllt sind:

Anforderung	Bedeutung
Genau ein Hypercall-Konto	Der Manager kontrolliert genau einen Account-Contract. Keiner oder mehr als einer führt zur Ablehnung.
Kein Standard-Guthaben	Das Standard-Margin-Bargeldguthaben der Wallet ist null. Jedes auszahlbare Guthaben blockiert den Wechsel.
Flat	Keine offenen Positionen und keine offenen Orders, weder auf der Manager-Wallet noch auf ihrem Account.

Diese Regeln bestehen, weil die beiden Modi unterschiedliche Kontoarten sind und nicht ein Konto mit einer Einstellung:

• Ihre Sicherheiten werden unterschiedlich verwahrt. Der Wechsel von Standard zu Portfolio Margin bedeutet, dass Ihre Mittel verschoben werden, nicht dass ein Schalter umgelegt wird.
• Positionen werden nach unterschiedlichen Regeln gemargint. Eine offene Position müsste von einem Regelwerk auf das andere umgerechnet werden.
• Daher erfolgt der Wechsel von einem leeren Konto aus. Beides sicher in einem Schritt zu erledigen, wird nicht unterstützt. Deshalb muss das Konto zuerst flat und leer sein.

Der Margin-Modus wird pro Manager-Wallet festgelegt, eine Wallet kann also nicht beide Modi gleichzeitig nutzen. Am einfachsten ist eine frische Manager-Wallet für PM. So kann Ihr bestehendes SM-Konto weiter quotieren, während Sie die Einrichtung vornehmen. Sie können auch Ihre bestehende Wallet leeren (alles schließen, alle Orders stornieren, das gesamte Standard-Guthaben abheben) und sie umstellen, aber Ihr SM-Buch kann in der Zwischenzeit nicht weiterlaufen.

Bevor Sie beginnen

• Eine neue Manager-Wallet (eine EOA, die Sie kontrollieren, idealerweise mit einem Hardware- oder anderweitig gesicherten Schlüssel).
• HYPE auf HyperEVM in dieser Wallet, für die Einzahlung bei der Kontoerstellung plus Gas.
• Die USDC, die Sie als Sicherheit verwenden möchten.

Einrichtungsschritte

Führen Sie diese Schritte in der angegebenen Reihenfolge aus. Schritt 4 muss vor Schritt 5 erfolgen.

1. Erstellen Sie eine neue Manager-Wallet. Verwenden Sie nicht erneut Ihren SM-Manager, eine API-Wallet oder einen Agent-Key.

2. Erstellen Sie Ihr Hypercall-Konto. Rufen Sie von der Manager-Wallet aus createAccount(salt) auf dem Factory-Contract mit der HYPE-Erstellungseinzahlung auf. Dadurch wird Ihr Account-Contract bereitgestellt und auf HyperCore aktiviert. Siehe Onboarding (Contracts). Erstellen Sie für diesen Manager nur ein Konto.

3. Aktivieren Sie den HyperCore Unified Account Mode für den Account. Senden Sie die Aktion hl_set_abstraction, signiert von der Manager-Wallet, mit user auf Ihre Account-Adresse und abstraction auf 2 (Unified Account) gesetzt. POST /v1/actions/hl_set_abstraction/typed-data liefert die exakten zu signierenden Typed Data, und POST /v1/actions/hl_set_abstraction übermittelt sie. Warten Sie, bis HyperCore den Account als unifiedAccount meldet. Die anderen Kontomodi von Hyperliquid, einschließlich des eigenen Portfolio-Margin-Modus von Hyperliquid, werden nicht unterstützt.

4. Wechseln Sie in den Portfolio-Modus. Senden Sie POST /margin-mode mit wallet auf Ihre Manager-Adresse und margin_mode auf portfolio gesetzt, signiert von der Manager-Wallet (siehe Authentifizierung). Die Antwort gibt Ihre Account-Adresse als PM-Wallet zurück. Tun Sie dies vor der Einzahlung: Solange sich eine Wallet noch im Standard-Modus befindet, wird eine Hypercall-Einzahlung als Standard-Guthaben gutgeschrieben, und dieses Guthaben blockiert den Wechsel, bis Sie es wieder abheben.

5. Zahlen Sie USDC auf Ihren Account ein. Zahlen Sie über die App ein, die nach Margin-Modus routet, oder senden Sie USDC auf HyperCore an Ihre Account-Adresse. Die Mittel zählen zur Margin, sobald der nächste HyperCore-Snapshot von Hypercall sie anzeigt.

6. Richten Sie Ihre Signaturschlüssel ein. Freigaben auf Ihrer alten SM-Wallet werden nicht übernommen.

   • Optionen (REST): Geben Sie Ihren Trading-Key für die neue Manager-Wallet mit POST /approve-agent frei. Siehe Agent-Autorisierung.
   • Perps (On-Chain-Direktiven): Registrieren Sie eine API-Wallet auf Ihrem Account mit der vom Manager signierten Aktion hc_update_api_wallet. Eine API-Wallet kann nur auf einem Account aktiv sein. Siehe EIP-712-Signierung.

7. Handeln Sie. Senden Sie bei Optionsanfragen weiterhin Ihre Manager-Adresse als wallet. Hypercall leitet sie an Ihr PM-Konto weiter. Ordertypen, die Order-API und die Signierung sind dieselben wie bei Standard Margin. Für Hyperliquid-Perps über die App siehe Perps auf Hypercall.

Wenn Sie in der App unter Settings > Margin Mode die Option Portfolio wählen, werden die Schritte 2 bis 4 für Sie ausgeführt: Das Konto wird erstellt, falls Sie noch keines haben, der Unified Account Mode wird aktiviert und der Modus wird gewechselt.

Wenn Sie den Unified Account Mode überspringen

Hypercall bewertet ein PM-Konto anhand seines HyperCore-Eigenkapitals, das HyperCore nur für Accounts im Unified Account Mode veröffentlicht. Befindet sich der Account nicht in diesem Modus, wird Schritt 4 mit 400 pm_account_not_unified abgelehnt. Schließen Sie Schritt 3 ab, warten Sie, bis HyperCore den Modus bestätigt, und versuchen Sie es dann erneut.

Verlässt ein Account später den Unified Account Mode, liefern Portfolio-Abfragen 503 pm_account_equity_pending (oder 409 pm_account_not_unified, falls HyperCore nie Eigenkapital dafür veröffentlicht hat), und Orders schlagen mit einem Fehler wie missing HyperCore account equity for PM wallet 0x... fehl. Aktivieren Sie den Unified Account Mode erneut, um das Problem zu beheben. Siehe Fehler und Ablehnungsgründe.

FAQ

Kann ich mein Standard-Margin-Konto weiterlaufen lassen? Ja. Richten Sie PM auf einer neuen Manager-Wallet ein und lassen Sie Ihr SM-Konto unverändert.

Warum wurde mein Wechsel des Margin-Modus abgelehnt? Die Fehlermeldung nennt die Regel: Die Wallet hat keinen Account (oder mehr als einen), sie hat ein Standard-Guthaben, sie hat offene Positionen oder Orders, oder der Account befindet sich noch nicht im HyperCore Unified Account Mode (pm_account_not_unified). Siehe Warum Sie mit einer neuen Wallet beginnen.

Ich habe vor dem Wechsel eingezahlt. Was nun? Die Einzahlung wurde als Standard-Guthaben gutgeschrieben. Heben Sie sie ab, wechseln Sie dann in den Portfolio-Modus und zahlen Sie auf Ihren Account ein.

Brauche ich neue API-Keys? Sie benötigen neue Freigaben. Agent-Freigaben für Optionen sind an die Manager-Wallet gebunden, geben Sie Ihren Key also für die neue Wallet erneut frei. Eine Perps-API-Wallet kann nur auf einem Account aktiv sein. Verwenden Sie daher einen neuen Key oder entfernen Sie ihn zuerst von Ihrem alten Account (Schritt 6).

Wo erfahre ich, wie PM-Margin, Liquidation und Settlement funktionieren? Siehe Portfolio Margin, PM-Margin: Rechenbeispiele, Margin Floor, Liquidation und Settlement.