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 utiliza da seguinte forma:

Campo	Descrição	Uso
oraclePx	Preço spot/índice externo	Entrada de spot canônica para toda a precificação
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" 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
• $t$ é o tempo até o vencimento (em anos)

Esse preço forward é usado para greeks, cálculos de risco e outros cômputos 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:

• Precificação de opções e greeks
• Cálculos de margem
• Monitoramento de risco
• Avaliações mark-to-market

Fonte de Dados

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

Ingerimos o campo oraclePx de metaAndAssetCtxs para cada ativo subjacente suportado.

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 precificação 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 opções em dinheiro no vencimento.

Regras de Liquidação

Parâmetro	Valor
Horário de vencimento	Mainnet SPCX: 16:00 ET. Testnet atualmente: 08:00 UTC
Preço de referência	TWAP de 30 minutos do oraclePx
Janela do TWAP	[expiry - 30 minutes, expiry]

Como Funciona

No vencimento, as posições são liquidadas em dinheiro usando um TWAP (Time-Weighted Average Price) 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 o preço de liquidação finalizado não estiver disponível quando o contrato vencer, o instrumento permanece em Expired Pending Price: a negociação é desabilitada, as ordens abertas são canceladas e a liquidação é reexecutada 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 (median-of-means) com corte de 5%:

1. Coletar amostras: reunir $n$ amostras de preço $\{p_1, p_2, \ldots, p_n\}$ durante a janela
2. Cortar outliers: ordenar e remover 5% de cada extremidade, produzindo o conjunto cortado $P'$ de tamanho $n' = 0.9n$
3. Particionar em buckets: dividir $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 final de liquidação:

$$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 à manipulação causada por picos de preço breves 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:

• Precificação de opções (entradas de Black-Scholes)
• Cálculos de risco de vega
• Requisitos de margem

Tratamento de Fontes

A Hypercall mantém superfícies de volatilidade implícita para os mercados suportados.

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 uma superfície de volatilidade em memória por ativo subjacente, com:

• IV específica por strike para os strikes configurados
• IV ATM como referência de linha de base
• Interpolação entre strikes e vencimentos quando os pontos de dados exatos não estão 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. Mercados com sessões de fonte fechadas podem usar um modelo sensível à sessão que transforma a última superfície válida da fonte, mas apenas quando todas as entradas necessárias forem válidas.