Orakel

Diese Seite beschreibt die Datenquellen und Regeln, die Hypercall verwendet für:

• Basiswertpreise (Spot und Forward/Mark)
• Settlement-Referenzpreise (Verfall-TWAP)
• Implizite Volatilität (IV) / Volatilitätsoberfläche

---

Terminologie

Die metaAndAssetCtxs-Antwort von Hyperliquid enthält mehrere Preisfelder. Hypercall verwendet sie wie folgt:

Feld	Beschreibung	Verwendung
oraclePx	Externer Spot-/Indexpreis	Kanonischer Spot-Input für sämtliche Preisberechnungen
markPx	Mark-Preis von Hyperliquid (Orakel plus Prämienanpassung)	Wird nicht als kanonischer Spot verwendet
midPx	Mittelkurs aus dem Hyperliquid-Orderbuch	Nur Referenz
impactPxs	Slippage-bereinigte Preise	Nur Referenz

Forward-/Mark-to-Expiry-Preis

Bei Hypercall kann sich „Mark-Preis“ auch auf einen Forward-Preis beziehen, der wie folgt berechnet wird:

$$F = S \times e^{r \cdot t}$$

Dabei gilt:

• $S$ ist der Orakel-/Index-Spot (oraclePx)
• $r$ ist der risikofreie Zinssatz, derzeit 5 %
• $t$ ist die Restlaufzeit bis zum Verfall (in Jahren)

Dieser Forward-Preis wird für Greeks, Risikoberechnungen und andere Berechnungen verwendet, die vom Forward statt vom Spot abhängen.

---

Basiswertpreis-Orakel

Zweck

Das Basiswertpreis-Orakel liefert Spotpreise in Echtzeit, die verwendet werden für:

• Optionsbewertung und Greeks
• Margin-Berechnungen
• Risikoüberwachung
• Mark-to-Market-Bewertungen

Datenquelle

Hyperliquid WebSocket API (wss://api.hyperliquid.xyz/ws)

Wir lesen das Feld oraclePx für jeden unterstützten Basiswert aus dem activeAssetCtx-WebSocket-Abonnement von Hyperliquid (dieselben Asset-Kontext-Felder, die metaAndAssetCtxs zurückgibt) und tasten es alle 2 Sekunden ab. Es gibt keinen HTTP-Polling-Fallback: Solange der Feed ausgefallen oder veraltet ist, wird das Orakel als nicht funktionsfähig markiert und es wird kein neuer Preis erfasst.

Basiswert	Hyperliquid-Markt
BTC, ETH	Haupt-Perp-DEX: BTC, ETH
SPCX, SP500, BOT, MU, NVDA, META, MSFT, AAPL, SNDK, BABA	xyz HIP-3-Perp-DEX: xyz:SPCX, xyz:SP500, xyz:NVDA usw.

Forward-Preis

Für jede Optionsserie mit zukünftigem Verfall berechnet Hypercall einen Forward-Preis mit der obigen Formel. So bleibt die Preisbildung bei allen Risiko- und Bewertungsberechnungen konsistent mit der Restlaufzeit.

---

Settlement-Orakel

Zweck

Das Settlement-Orakel bestimmt den Referenzpreis, der für das Cash-Settlement von Exchange-Optionen bei Verfall verwendet wird.

Settlement-Regeln

Parameter	Wert
Verfallszeit	BTC und ETH: 08:00 UTC. Alle anderen Basiswerte: 20:00 UTC (16:00 Uhr New Yorker Zeit, solange in den USA Sommerzeit gilt)
Referenzpreis	30-Minuten-TWAP von oraclePx
TWAP-Fenster	[expiry - 30 minutes, expiry]
Mindestanzahl an Samples	500

Funktionsweise

Bei Verfall werden Exchange-Positionen per Cash-Settlement anhand eines 30-minütigen zeitgewichteten Durchschnittspreises (TWAP) des Orakel-Spotpreises des Basiswerts abgerechnet. Der TWAP glättet kurzfristige Volatilität und liefert eine manipulationsresistente Settlement-Referenz.

Für das Settlement wird ausschließlich der finalisierte TWAP verwendet. Hat Hypercall im Fenster weniger als 500 Samples erfasst (zum Beispiel nach einem Neustart innerhalb des Fensters), kann es das Fenster aus der archivierten Hyperliquid-Orakelhistorie unter derselben Mindestanzahl von 500 Samples rekonstruieren. Ist der finalisierte Settlement-Preis bei Verfall des Kontrakts weiterhin nicht verfügbar, bleibt das Instrument im Status Expired Pending Price: Der Handel ist deaktiviert, offene Orders werden storniert, und das Settlement wird so lange erneut versucht, bis der finalisierte Orakelpreis vorliegt.

TWAP-Berechnungsmethode

Der Settlement-Preis wird mit einem Median-of-Means-Algorithmus mit 5 % Trimming berechnet:

1. Samples sammeln: Erfassen Sie $n$ Preis-Samples $\{p_1, p_2, \ldots, p_n\}$ während des Fensters
2. Ausreißer entfernen: Sortieren und an jedem Ende 5 % entfernen, sodass sich die getrimmte Menge $P'$ der Größe $n' = 0.9n$ ergibt
3. In Buckets aufteilen: $P'$ in $k \approx \sqrt{n'}$ gleich große Buckets $B_1, B_2, \ldots, B_k$ aufteilen
4. Bucket-Mittelwerte berechnen:

$$\mu_i = \frac{1}{|B_i|} \sum_{p \in B_i} p$$

5. Endgültiger Settlement-Preis:

$$P_{\text{Settlement}} = \text{Median}(\mu_1, \mu_2, \ldots, \mu_k)$$

Dieser Ansatz ist robuster als ein einfacher Durchschnitt, da er Manipulationen durch kurze Preisspitzen oder Flash-Crashs während des Settlement-Fensters widersteht.

---

Orakel für implizite Volatilität

Zweck

Das IV-Orakel liefert die Volatilitätsoberfläche, die verwendet wird für:

• Optionsbewertung (Black-Scholes-Inputs)
• Vega-Risikoberechnungen
• Margin-Anforderungen

Quelle

Jeder Basiswert hat genau eine konfigurierte Volatilitätsquelle: Deribit für BTC und ETH, Daten börsennotierter US-Optionen für Aktien- und Index-Basiswerte und realisierte Volatilität für BOT. Die Tabelle finden Sie unter Volatilitätsorakel. Die Engine prüft vor der Verwendung die Quelle, das Alter des Snapshots und die Oberfläche selbst.

Unter Volatilitätsorakel finden Sie Details zur Behandlung geschlossener Handelssitzungen und zum Fail-Closed-Verhalten.

Volatilitätsoberfläche

Hypercall hält pro Basiswert eine Volatilitätsoberfläche im Arbeitsspeicher vor, mit:

• Strike-spezifischer IV für konfigurierte Ausübungspreise
• ATM-IV als Basisreferenz
• Interpolation über Ausübungspreise und Verfallstermine, wenn keine exakten Datenpunkte verfügbar sind

Umgang mit veralteten Daten

Sind erforderliche Volatilitätsdaten nicht verfügbar oder veraltet, schlägt das System bei Berechnungen, die von dieser IV abhängen, geschlossen fehl (Fail-Closed). Wenn der US-Optionsmarkt geschlossen ist, stammen Aktien- und Indexoberflächen aus dem Snapshot, der zum letzten Sitzungsschluss erstellt wurde. Die Altersgrenzen finden Sie unter Volatilitätsorakel.