Oracles

Cette page décrit les sources de données et les règles utilisées par Hypercall pour :

• Les prix des sous-jacents (spot et forward/mark)
• Les prix de référence de règlement (TWAP à l'échéance)
• La volatilité implicite (IV) / surface de volatilité

---

Terminologie

La réponse metaAndAssetCtxs de Hyperliquid contient plusieurs champs de prix. Hypercall les utilise comme suit :

Champ	Description	Utilisation
oraclePx	Prix spot/indice externe	Entrée spot canonique pour tous les calculs de prix
markPx	Prix mark de Hyperliquid (oracle plus ajustement de prime)	Non utilisé comme spot canonique
midPx	Prix milieu du carnet d'ordres Hyperliquid	Référence uniquement
impactPxs	Prix tenant compte du slippage	Référence uniquement

Prix forward / Mark-to-Expiry

Dans Hypercall, le « prix mark » peut également désigner un prix forward calculé comme suit :

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

Où :

• $S$ est le spot oracle/indice (oraclePx)
• $r$ est le taux sans risque
• $t$ est le temps jusqu'à l'échéance (en années)

Ce prix forward est utilisé pour les greeks, les calculs de risque et les autres calculs qui dépendent du forward plutôt que du spot.

---

Oracle de prix du sous-jacent

Objectif

L'oracle de prix du sous-jacent fournit des prix spot en temps réel utilisés pour :

• La valorisation des options et les greeks
• Les calculs de marge
• La surveillance des risques
• Les valorisations mark-to-market

Source de données

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

Nous ingérons le champ oraclePx de metaAndAssetCtxs pour chaque actif sous-jacent pris en charge.

Prix forward

Pour toute série d'options avec une échéance future, Hypercall calcule un prix forward à l'aide de la formule ci-dessus. Cela garantit la cohérence des prix par rapport au temps jusqu'à l'échéance dans tous les calculs de risque et de valorisation.

---

Oracle de règlement

Objectif

L'oracle de règlement détermine le prix de référence utilisé pour le règlement en espèces des options à l'échéance.

Règles de règlement

Paramètre	Valeur
Heure d'échéance	Réseau principal SPCX : 16h00 ET. Testnet actuellement : 08h00 UTC
Prix de référence	TWAP sur 30 minutes de oraclePx
Fenêtre TWAP	[expiry - 30 minutes, expiry]

Fonctionnement

À l'échéance, les positions sont réglées en espèces à l'aide d'un prix moyen pondéré dans le temps (TWAP) sur 30 minutes du prix spot oracle du sous-jacent. Le TWAP lisse la volatilité à court terme et fournit une référence de règlement résistante à la manipulation.

Le règlement utilise uniquement le TWAP finalisé. Si le prix de règlement finalisé n'est pas disponible au moment de l'expiration du contrat, l'instrument reste dans l'état Expired Pending Price : le trading est désactivé, les ordres ouverts sont annulés, et le règlement est retenté jusqu'à ce que le prix oracle finalisé soit disponible.

Méthode de calcul du TWAP

Le prix de règlement est calculé à l'aide d'un algorithme de médiane des moyennes avec troncature de 5 % :

1. Collecte des échantillons : rassembler $n$ échantillons de prix $\{p_1, p_2, \ldots, p_n\}$ pendant la fenêtre
2. Troncature des valeurs aberrantes : trier et retirer 5 % de chaque extrémité, produisant un ensemble tronqué $P'$ de taille $n' = 0.9n$
3. Partitionnement en groupes : diviser $P'$ en $k \approx \sqrt{n'}$ groupes de taille égale $B_1, B_2, \ldots, B_k$
4. Calcul des moyennes par groupe :

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

5. Prix de règlement final :

$$P_{\text{règlement}} = \text{median}(\mu_1, \mu_2, \ldots, \mu_k)$$

Cette approche est plus robuste qu'une simple moyenne, car elle résiste à la manipulation par de brefs pics de prix ou des flash crashs pendant la fenêtre de règlement.

---

Oracle de volatilité implicite

Objectif

L'oracle d'IV fournit la surface de volatilité utilisée pour :

• La valorisation des options (paramètres d'entrée de Black-Scholes)
• Les calculs de risque véga
• Les exigences de marge

Gestion des sources

Hypercall maintient des surfaces de volatilité implicite pour les marchés pris en charge.

Voir Oracle de volatilité pour la gestion des sessions fermées et le comportement fail-closed.

Surface de volatilité

Hypercall maintient une surface de volatilité en mémoire par sous-jacent, avec :

• Une IV spécifique par strike pour les strikes configurés
• Une IV à la monnaie (ATM) comme référence de base
• Une interpolation entre les strikes et les échéances lorsque les points de données exacts ne sont pas disponibles

Gestion des données obsolètes

Si les données de volatilité requises sont indisponibles ou obsolètes, le système adopte un comportement fail-closed pour les calculs qui dépendent de cette IV. Les marchés dont les sessions sources sont fermées peuvent utiliser un modèle tenant compte des sessions qui transforme la dernière surface source valide, mais uniquement lorsque toutes les entrées requises sont valides.