Oráculos

Esta página descreve as fontes de dados e as regras que a Hypercall usa para:

• Preços do ativo subjacente (spot e forward/mark)
• Preços de referência de liquidação (TWAP de vencimento)
• Volatilidade implícita (IV) / superfície de volatilidade

---

Terminologia

A resposta metaAndAssetCtxs da Hyperliquid contém vários campos de preço. A Hypercall os usa da seguinte forma:

Campo	Descrição	Uso
oraclePx	Preço spot/índice externo	Entrada canônica de spot para todo o apreçamento
markPx	Preço de marcação da Hyperliquid (oráculo mais ajuste de prêmio)	Não usado como spot canônico
midPx	Preço médio do livro de ofertas da Hyperliquid	Apenas referência
impactPxs	Preços que consideram slippage	Apenas referência

Preço Forward/Mark-to-Expiry

Na Hypercall, "preço de marcação" (mark price) também pode se referir a um preço forward calculado como:

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

Onde:

• $S$ é o spot do oráculo/índice (oraclePx)
• $r$ é a taxa livre de risco, atualmente 5%
• $t$ é o tempo até o vencimento (em anos)

Esse preço forward é usado para as gregas, cálculos de risco e outros cálculos que dependem do forward em vez do spot.

---

Oráculo de Preço do Ativo Subjacente

Finalidade

O oráculo de preço do ativo subjacente fornece preços spot em tempo real usados para:

• Apreçamento de opções e gregas
• Cálculos de margem
• Monitoramento de risco
• Avaliações mark-to-market

Fonte de Dados

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

Lemos o campo oraclePx de cada ativo subjacente suportado a partir da assinatura WebSocket activeAssetCtx da Hyperliquid (os mesmos campos de contexto de ativo que o metaAndAssetCtxs retorna) e o amostramos a cada 2 segundos. Não há fallback de polling HTTP: enquanto o feed estiver fora do ar ou desatualizado, o oráculo é marcado como não saudável e nenhum novo preço é registrado.

Ativo subjacente	Mercado na Hyperliquid
BTC, ETH	DEX de perpétuos principal: BTC, ETH
SPCX, SP500, BOT, MU, NVDA, META, MSFT, AAPL, SNDK, BABA	DEX de perpétuos HIP-3 xyz: xyz:SPCX, xyz:SP500, xyz:NVDA e assim por diante

Preço Forward

Para qualquer série de opções com vencimento futuro, a Hypercall calcula um preço forward usando a fórmula acima. Isso garante consistência de apreçamento com o tempo até o vencimento em todos os cálculos de risco e avaliação.

---

Oráculo de Liquidação

Finalidade

O oráculo de liquidação determina o preço de referência usado para liquidar financeiramente as opções da Exchange no vencimento.

Regras de Liquidação

Parâmetro	Valor
Horário de vencimento	BTC e ETH: 08:00 UTC. Todos os outros ativos subjacentes: 20:00 UTC (16:00 no horário de Nova York enquanto vigora o horário de verão dos EUA)
Preço de referência	TWAP de 30 minutos do oraclePx
Janela do TWAP	[expiry - 30 minutes, expiry]
Mínimo de amostras	500

Como Funciona

No vencimento, as posições da Exchange são liquidadas financeiramente usando um Preço Médio Ponderado pelo Tempo (TWAP) de 30 minutos do preço spot do oráculo do ativo subjacente. O TWAP suaviza a volatilidade de curto prazo e fornece uma referência de liquidação resistente a manipulação.

A liquidação usa apenas o TWAP finalizado. Se a Hypercall coletou menos de 500 amostras na janela (por exemplo, após uma reinicialização dentro dela), ela pode reconstruir a janela a partir do histórico arquivado do oráculo da Hyperliquid, sob o mesmo mínimo de 500 amostras. Se o preço de liquidação finalizado ainda não estiver disponível quando o contrato vencer, o instrumento permanece em Expired Pending Price: a negociação é desativada, as ordens abertas são canceladas e a liquidação é tentada novamente até que o preço finalizado do oráculo esteja disponível.

Método de Cálculo do TWAP

O preço de liquidação é calculado usando um algoritmo de mediana das médias com aparo de 5%:

1. Coletar amostras: reúna $n$ amostras de preço $\{p_1, p_2, \ldots, p_n\}$ durante a janela
2. Aparar outliers: ordene e remova 5% de cada cauda, obtendo o conjunto aparado $P'$ de tamanho $n' = 0.9n$
3. Particionar em buckets: divida $P'$ em $k \approx \sqrt{n'}$ buckets de tamanho igual $B_1, B_2, \ldots, B_k$
4. Calcular as médias dos buckets:

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

5. Preço de liquidação final:

$$P_{\text{liquidação}} = \text{mediana}(\mu_1, \mu_2, \ldots, \mu_k)$$

Essa abordagem é mais robusta do que uma média simples, pois resiste a manipulação por picos breves de preço ou flash crashes durante a janela de liquidação.

---

Oráculo de Volatilidade Implícita

Finalidade

O oráculo de IV fornece a superfície de volatilidade usada para:

• Apreçamento de opções (entradas do Black-Scholes)
• Cálculos de risco de vega
• Requisitos de margem

Fonte

Cada ativo subjacente tem uma única fonte de volatilidade configurada: Deribit para BTC e ETH, dados de opções listadas nos EUA para subjacentes de ações e índices, e volatilidade realizada para BOT. Veja a tabela em Oráculo de Volatilidade. O engine verifica a fonte, a idade do snapshot e a própria superfície antes de usar um deles.

Veja Oráculo de Volatilidade para o tratamento de sessões fechadas e o comportamento fail-closed.

Superfície de Volatilidade

A Hypercall mantém em memória uma superfície de volatilidade por ativo subjacente, com:

• IV específica por strike para os strikes configurados
• IV ATM como referência de base
• Interpolação entre strikes e vencimentos quando não há pontos de dados exatos disponíveis

Tratamento de Dados Desatualizados

Se os dados de volatilidade necessários estiverem indisponíveis ou desatualizados, o sistema falha de forma fechada (fail-closed) para os cálculos que dependem dessa IV. Quando o mercado de opções dos EUA está fechado, as superfícies de ações e índices vêm do snapshot tirado no fechamento da última sessão. Veja Oráculo de Volatilidade para os limites de idade.