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	Entrada spot canónica 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 como referencia
impactPxs	Precios que consideran el slippage (deslizamiento)	Solo como referencia

Precio forward/mark al vencimiento

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, actualmente del 5%
• $t$ es el tiempo hasta el vencimiento (en años)

Este precio forward se utiliza para las griegas, los cálculos de riesgo y otros cálculos 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 que se utilizan para:

• Pricing de opciones y griegas
• Cálculos de margen
• Monitoreo de riesgo
• Valoraciones mark-to-market

Fuente de datos

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

Leemos el campo oraclePx de cada activo subyacente soportado desde la suscripción WebSocket activeAssetCtx de Hyperliquid (los mismos campos de contexto del activo que devuelve metaAndAssetCtxs) y lo muestreamos cada 2 segundos. No existe un respaldo mediante consultas HTTP: mientras el feed esté caído o desactualizado, el oráculo se marca como no saludable y no se registra ningún precio nuevo.

Activo subyacente	Mercado de Hyperliquid
BTC, ETH	Dex principal de perpetuos: BTC, ETH
SPCX, SP500, BOT, MU, NVDA, META, MSFT, AAPL, SNDK, BABA	Dex de perpetuos HIP-3 xyz: xyz:SPCX, xyz:SP500, xyz:NVDA, etc.

Precio forward

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

---

Oráculo de liquidación al vencimiento

Propósito

El oráculo de liquidación determina el precio de referencia que se utiliza para liquidar en efectivo las opciones de Exchange al vencimiento.

Reglas de liquidación al vencimiento

Parámetro	Valor
Hora de vencimiento	BTC y ETH: 08:00 UTC. Todos los demás activos subyacentes: 20:00 UTC (4:00 PM hora de Nueva York mientras está vigente el horario de verano de EE. UU.)
Precio de referencia	TWAP de 30 minutos de oraclePx
Ventana del TWAP	[expiry - 30 minutes, expiry]
Muestras mínimas	500

Cómo funciona

Al vencimiento, las posiciones de Exchange se liquidan en efectivo utilizando un precio promedio ponderado por tiempo (TWAP) 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 liquidación resistente a la manipulación.

La liquidación al vencimiento utiliza únicamente el TWAP finalizado. Si Hypercall recopiló menos de 500 muestras en la ventana (por ejemplo, tras un reinicio dentro de ella), puede reconstruir la ventana a partir del historial archivado del oráculo de Hyperliquid con el mismo mínimo de 500 muestras. Si el precio de liquidación finalizado sigue sin estar disponible cuando vence el contrato, el instrumento permanece en Expired Pending Price: el trading se deshabilita, las órdenes abiertas se cancelan y la liquidación se reintenta hasta que el precio finalizado del oráculo esté disponible.

Método de cálculo del TWAP

El precio de liquidación se calcula mediante un algoritmo de mediana de medias con un recorte del 5%:

1. Recopilar muestras: se reúnen $n$ muestras de precio $\{p_1, p_2, \ldots, p_n\}$ durante la ventana
2. Recortar valores atípicos: se ordenan y se elimina el 5% de cada extremo, lo que da como resultado el conjunto recortado $P'$ de tamaño $n' = 0.9n$
3. Dividir en grupos: se divide $P'$ en $k \approx \sqrt{n'}$ grupos de igual tamaño $B_1, B_2, \ldots, B_k$
4. Calcular las medias de cada grupo:

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

5. Precio final de liquidación:

$$P_{\text{liquidación}} = \text{mediana}(\mu_1, \mu_2, \ldots, \mu_k)$$

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

---

Oráculo de volatilidad implícita

Propósito

El oráculo de IV proporciona la superficie de volatilidad que se utiliza para:

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

Fuente

Cada subyacente tiene una única fuente de volatilidad configurada: Deribit para BTC y ETH, datos de opciones cotizadas en EE. UU. para los subyacentes de acciones e índices, y volatilidad realizada para BOT. Consulte la tabla en Oráculo de volatilidad. El motor verifica la fuente, la antigüedad del snapshot y la propia superficie antes de utilizarlo.

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

Superficie de volatilidad

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

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

Manejo de datos desactualizados

Si los datos de volatilidad requeridos no están disponibles o están desactualizados, el sistema falla de forma cerrada (fail-closed) en los cálculos que dependen de esa IV. Cuando el mercado de opciones de EE. UU. está cerrado, las superficies de renta variable e índices provienen del snapshot tomado al cierre de la última sesión. Consulte Oráculo de volatilidad para conocer los límites de antigüedad.