Oracles

Cette page décrit les sources de données et les règles qu'Hypercall utilise pour :

• Les prix des actifs 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 toute la tarification
markPx	Prix mark de Hyperliquid (oracle plus ajustement de prime)	Non utilisé comme spot canonique
midPx	Prix médian issu du carnet d'ordres Hyperliquid	Référence uniquement
impactPxs	Prix tenant compte du slippage	Référence uniquement

Prix forward / mark à l'échéance

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

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

Où :

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

Ce prix forward est utilisé pour les grecques, 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 tarification des options et les grecques
• Les calculs de marge
• La surveillance des risques
• Les valorisations au prix du marché (mark-to-market)

Source de données

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

Nous lisons le champ oraclePx de chaque sous-jacent pris en charge depuis l'abonnement WebSocket activeAssetCtx de Hyperliquid (les mêmes champs de contexte d'actif que renvoie metaAndAssetCtxs) et l'échantillonnons toutes les 2 secondes. Il n'existe aucun repli par interrogation HTTP : tant que le flux est interrompu ou obsolète, l'oracle est marqué comme défaillant et aucun nouveau prix n'est enregistré.

Sous-jacent	Marché Hyperliquid
BTC, ETH	DEX perpétuel principal : BTC, ETH
SPCX, SP500, BOT, MU, NVDA, META, MSFT, AAPL, SNDK, BABA	DEX perpétuel HIP-3 xyz : xyz:SPCX, xyz:SP500, xyz:NVDA, etc.

Prix forward

Pour toute série d'options dont l'échéance est future, Hypercall calcule un prix forward à l'aide de la formule ci-dessus. Cela garantit une tarification cohérente avec le temps restant jusqu'à l'échéance dans l'ensemble des 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 régler en numéraire les options Exchange à l'échéance.

Règles de règlement

Paramètre	Valeur
Heure d'échéance	BTC et ETH : 08:00 UTC. Tous les autres sous-jacents : 20:00 UTC (16:00, heure de New York, pendant l'heure d'été américaine)
Prix de référence	TWAP sur 30 minutes de oraclePx
Fenêtre TWAP	[expiry - 30 minutes, expiry]
Nombre minimal d'échantillons	500

Fonctionnement

À l'échéance, les positions Exchange sont réglées en numéraire à 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é de court terme et fournit une référence de règlement résistante à la manipulation.

Le règlement utilise uniquement le TWAP finalisé. Si Hypercall a collecté moins de 500 échantillons dans la fenêtre (par exemple après un redémarrage survenu pendant celle-ci), il peut reconstruire la fenêtre à partir de l'historique archivé des prix oracle de Hyperliquid, avec le même minimum de 500 échantillons. Si le prix de règlement finalisé n'est toujours pas disponible à l'expiration du contrat, l'instrument reste à 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 un rognage de 5 % :

1. Collecte des échantillons : recueillir $n$ échantillons de prix $\{p_1, p_2, \ldots, p_n\}$ pendant la fenêtre
2. Suppression des valeurs aberrantes : trier et retirer 5 % à chaque extrémité, ce qui donne l'ensemble rogné $P'$ de taille $n' = 0.9n$
3. Répartition en compartiments : diviser $P'$ en $k \approx \sqrt{n'}$ compartiments de taille égale $B_1, B_2, \ldots, B_k$
4. Calcul des moyennes par compartiment :

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

5. Prix de règlement final :

$$P_{\text{règlement}} = \text{médiane}(\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 krachs éclair 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 tarification des options (entrées de Black-Scholes)
• Les calculs de risque véga
• Les exigences de marge

Source

Chaque sous-jacent a une seule source de volatilité configurée : Deribit pour BTC et ETH, les données d'options cotées aux États-Unis pour les sous-jacents actions et indices, et la volatilité réalisée pour BOT. Voir le tableau dans Oracle de volatilité. Le moteur vérifie la source, l'âge de l'instantané et la surface elle-même avant de l'utiliser.

Consultez Oracle de volatilité pour le traitement des séances fermées et le comportement en mode fermé en cas de défaillance (fail-closed).

Surface de volatilité

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

• Une IV propre à chaque prix d'exercice configuré
• L'IV ATM comme référence de base
• Une interpolation entre prix d'exercice et é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 se met en mode fermé (fail-closed) pour les calculs qui dépendent de cette IV. Lorsque le marché américain des options est fermé, les surfaces des actions et des indices proviennent de l'instantané pris à la clôture de la dernière séance. Consultez Oracle de volatilité pour les limites d'âge.