Oracles

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

• Basiswert-Preise (Spot und Forward/Mark)
• Settlement-Referenzpreise (Verfalls-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-/Index-Preis	Kanonischer Spot-Input für alle Preisberechnungen
markPx	Mark-Preis von Hyperliquid (Oracle plus Prämienanpassung)	Nicht als kanonischer Spot verwendet
midPx	Mittelkurs aus dem Hyperliquid-Orderbuch	Nur als Referenz
impactPxs	Slippage-bewusste Preise	Nur als Referenz

Forward-/Mark-to-Expiry-Preis

In 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 Oracle-/Index-Spot (oraclePx)
• $r$ ist der risikofreie Zinssatz
• $t$ ist die Zeit 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.

---

Basiswert-Preis-Oracle

Zweck

Das Basiswert-Preis-Oracle liefert Echtzeit-Spotpreise, die verwendet werden für:

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

Datenquelle

Hyperliquid Info API (https://api.hyperliquid.xyz/info)

Wir beziehen das Feld oraclePx aus metaAndAssetCtxs für jeden unterstützten Basiswert.

Forward-Preis

Für jede Optionsserie mit einem zukünftigen Verfall berechnet Hypercall einen Forward-Preis anhand der obigen Formel. Dies stellt die Preiskonsistenz mit der Restlaufzeit über alle Risiko- und Bewertungsberechnungen hinweg sicher.

---

Settlement-Oracle

Zweck

Das Settlement-Oracle bestimmt den Referenzpreis, der für die Barabrechnung von Optionen bei Verfall verwendet wird.

Settlement-Regeln

Parameter	Wert
Verfallszeitpunkt	Mainnet SPCX: 16:00 Uhr ET. Testnet aktuell: 08:00 UTC
Referenzpreis	30-minütiger TWAP von oraclePx
TWAP-Fenster	[expiry - 30 minutes, expiry]

Funktionsweise

Bei Verfall werden Positionen anhand eines 30-minütigen zeitgewichteten Durchschnittspreises (Time-Weighted Average Price, TWAP) des Oracle-Spotpreises des Basiswerts bar abgerechnet. Der TWAP glättet kurzfristige Volatilität und bietet eine manipulationsresistente Settlement-Referenz.

Das Settlement verwendet ausschließlich den finalisierten TWAP. Wenn der finalisierte Abrechnungspreis bei Verfall des Kontrakts nicht verfügbar ist, verbleibt das Instrument im Status Expired Pending Price: Der Handel wird deaktiviert, offene Orders werden storniert, und das Settlement wird wiederholt, bis der finalisierte Oracle-Preis verfügbar ist.

TWAP-Berechnungsmethode

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

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

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

5. Finaler Abrechnungspreis:

$$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-Crashes während des Settlement-Fensters widersteht.

---

Oracle für implizite Volatilität

Zweck

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

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

Umgang mit Quellen

Hypercall pflegt implizite Volatilitätsoberflächen für unterstützte Märkte.

Siehe Volatility Oracle für den Umgang mit geschlossenen Handelssitzungen und das Fail-Closed-Verhalten.

Volatilitätsoberfläche

Hypercall verwaltet eine In-Memory-Volatilitätsoberfläche pro Basiswert, mit:

• Strike-spezifischer IV für konfigurierte Strikes
• ATM-IV als Basisreferenz
• Interpolation über Strikes und Verfallstermine hinweg, wenn exakte Datenpunkte nicht verfügbar sind

Umgang mit veralteten Daten

Wenn erforderliche Volatilitätsdaten nicht verfügbar oder veraltet sind, schaltet das System für Berechnungen, die von dieser IV abhängen, auf Fail-Closed. Märkte mit geschlossenen Quellsitzungen können ein sitzungsbewusstes Modell verwenden, das die letzte gültige Quelloberfläche transformiert – jedoch nur, wenn alle erforderlichen Inputs gültig sind.