Oráculos

Esta página describe las fuentes de datos y las reglas que Hypercall utiliza para:

• Precios del activo subyacente (spot y forward/mark)
• Precios de referencia de liquidación al vencimiento (TWAP de vencimiento)
• Volatilidad implícita (IV) / superficie de volatilidad

---

Terminología

La respuesta metaAndAssetCtxs de Hyperliquid contiene varios campos de precio. Hypercall los utiliza de la siguiente manera:

Campo	Descripción	Uso
oraclePx	Precio spot/índice externo	Input spot canónico para todo el pricing
markPx	Precio mark de Hyperliquid (oráculo más ajuste de prima)	No se usa como spot canónico
midPx	Precio medio del libro de órdenes de Hyperliquid	Solo referencia
impactPxs	Precios ajustados por slippage	Solo referencia

Precio Forward/Mark-to-Expiry

En Hypercall, "precio mark" también puede referirse a un precio forward calculado como:

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

Donde:

• $S$ es el spot del oráculo/índice (oraclePx)
• $r$ es la tasa libre de riesgo
• $t$ es el tiempo hasta el vencimiento (en años)

Este precio forward se utiliza para las greeks, los cálculos de riesgo y otros cómputos que dependen del forward en lugar del spot.

---

Oráculo de Precio del Activo Subyacente

Propósito

El oráculo de precio del activo subyacente proporciona precios spot en tiempo real utilizados para:

• Pricing de opciones y greeks
• Cálculos de margen
• Monitoreo de riesgo
• Valuaciones mark-to-market

Fuente de Datos

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

Ingerimos el campo oraclePx de metaAndAssetCtxs para cada activo subyacente soportado.

Precio Forward

Para cualquier serie de opciones con un vencimiento futuro, Hypercall calcula un precio forward utilizando la fórmula anterior. Esto garantiza la consistencia del pricing con el tiempo hasta el vencimiento en todos los cálculos de riesgo y valuación.

---

Oráculo de Settlement

Propósito

El oráculo de settlement determina el precio de referencia utilizado para liquidar las opciones en efectivo al vencimiento.

Reglas de Settlement

Parámetro	Valor
Hora de vencimiento	Mainnet SPCX: 4:00 PM ET. Testnet actualmente: 08:00 UTC
Precio de referencia	TWAP de 30 minutos de oraclePx
Ventana del TWAP	[expiry - 30 minutes, expiry]

Cómo Funciona

Al vencimiento, las posiciones se liquidan en efectivo utilizando un TWAP (Time-Weighted Average Price) de 30 minutos del precio spot del oráculo del activo subyacente. El TWAP suaviza la volatilidad de corto plazo y proporciona una referencia de settlement resistente a la manipulación.

El settlement utiliza únicamente el TWAP finalizado. Si el precio de settlement finalizado no está disponible cuando el contrato vence, el instrumento permanece en Expired Pending Price: el trading se deshabilita, las órdenes abiertas se cancelan y el settlement se reintenta hasta que el precio finalizado del oráculo esté disponible.

Método de Cálculo del TWAP

El precio de settlement se calcula utilizando un algoritmo de mediana de medias con recorte del 5%:

1. Recolectar muestras: Reunir $n$ muestras de precio $\{p_1, p_2, \ldots, p_n\}$ durante la ventana
2. Recortar valores atípicos: Ordenar y eliminar el 5% de cada extremo, obteniendo el conjunto recortado $P'$ de tamaño $n' = 0.9n$
3. Particionar en buckets: Dividir $P'$ en $k \approx \sqrt{n'}$ buckets de igual tamaño $B_1, B_2, \ldots, B_k$
4. Calcular las medias de cada bucket:

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

5. Precio de settlement final:

$$P_{\text{settlement}} = \text{median}(\mu_1, \mu_2, \ldots, \mu_k)$$

Este enfoque es más robusto que un promedio simple, ya que resiste la manipulación por picos de precio breves o flash crashes durante la ventana de settlement.

---

Oráculo de Volatilidad Implícita

Propósito

El oráculo de IV proporciona la superficie de volatilidad utilizada para:

• Pricing de opciones (inputs de Black-Scholes)
• Cálculos de riesgo vega
• Requisitos de margen

Manejo de Fuentes

Hypercall mantiene superficies de volatilidad implícita para los mercados soportados.

Consulte Oráculo de Volatilidad para el manejo de sesiones cerradas y el comportamiento fail-closed.

Superficie de Volatilidad

Hypercall mantiene una superficie de volatilidad en memoria por activo subyacente, con:

• IV específica por strike para los strikes configurados
• IV at the money (ATM) como referencia base
• Interpolación entre strikes y vencimientos cuando no hay puntos de datos exactos disponibles

Manejo de Datos Obsoletos

Si los datos de volatilidad requeridos no están disponibles o están obsoletos, el sistema falla en modo cerrado (fail-closed) para los cálculos que dependen de esa IV. Los mercados con sesiones de fuente cerradas pueden usar un modelo consciente de la sesión que transforma la última superficie de fuente válida, pero solo cuando todos los inputs requeridos son válidos.