Liquidação

A liquidação protege o sistema contra contas que não conseguem mais cumprir suas obrigações de margem. Quando o patrimônio de uma conta cai abaixo do requisito de margem de manutenção, a Hypercall primeiro tenta recuperar a conta fechando as opções vendidas. Se isso não resolver a tempo, a conta passa para a liquidação total.

Condições de disparo

A liquidação é disparada quando uma conta fica underwater:

Margem de portfólio:

$$\text{Patrimônio} < \text{Margem de Manutenção Exigida}$$

Margem padrão:

$$\text{Caixa} < \text{MM Exigida}$$

Na SM, a liquidação é determinada pela folga de manutenção em caixa (cash - mm_required), e não pelo patrimônio. Por isso, marcações de opções compradas que elevam o NAV não evitam um déficit de caixa. O campo maintenance_margin = equity - mm_required da API continua sendo informado, mas não é o gatilho de liquidação da SM. Consulte Margem padrão.

Em uma conta com margem de portfólio, o patrimônio é calculado já descontando o que a conta deve ao pool de empréstimo de PM, e o requisito de manutenção também considera a liquidação dos seus perpétuos pela própria Hyperliquid na HyperCore. A Hyperliquid ainda pode liquidar esses perpétuos pelas próprias regras, de forma independente da Hypercall. Consulte Margem de portfólio.

A Hypercall verifica a saúde de todas as contas com posições a cada 5 segundos.

Estados

Estado	O que está acontecendo	Ordens
Healthy	PM: patrimônio igual ou acima da MM exigida. SM: caixa igual ou acima da MM exigida.	Todas as ordens permitidas
PreLiquidation	Liquidação parcial: a Hypercall envia ordens de fechamento para as opções vendidas da conta	Apenas ordens que reduzem uma posição existente
InLiquidation	Liquidação total. Margem padrão: o book da conta é oferecido a um liquidante	Apenas ordens que reduzem uma posição existente
Liquidated	Um liquidante assumiu o book da conta	Apenas ordens que reduzem uma posição existente

Saques e varreduras de caixa da PM ficam desativados em PreLiquidation e InLiquidation. Quando uma conta PM está sendo esvaziada para a liquidação total, todas as suas ordens são bloqueadas.

Transições de estado

1. Healthy para PreLiquidation: a conta cai abaixo do seu limite de MM.
2. PreLiquidation para Healthy: a conta atinge a meta com buffer, MM exigida × 1,05, e nenhuma das suas ordens de liquidação continua aberta. O limite é inclusivo.
3. PreLiquidation para InLiquidation: a conta continua abaixo da meta e uma das condições de escalada abaixo é atendida.
4. InLiquidation para Healthy: a conta se recupera antes que um liquidante a assuma, e a liquidação total é interrompida.
5. InLiquidation para Liquidated: um liquidante assume a conta.

Liquidação parcial

Quando uma conta entra em PreLiquidation:

1. Ordens que aumentariam o risco são rejeitadas imediatamente. Ordens que reduzem uma posição existente continuam sendo aceitas.
2. A Hypercall cancela suas ordens abertas que aumentam o risco e envia ordens de compra reduce-only nas suas opções vendidas, dimensionadas para levar a conta de volta a MM exigida × 1,05. Ela fecha primeiro as posições vendidas que liberam mais margem por contrato.
3. Cada ordem tem preço igual ao melhor ask (ou ao mid, ou ao bid, se não houver ask) mais um bônus de liquidação. O bônus começa em 0,5% e sobe linearmente até 10% ao longo de 5 minutos. As ordens são reprecificadas a cada 5 segundos.
4. Assim que a conta volta a ficar igual ou acima da meta e as ordens de liquidação saem do livro, ela retorna a Healthy.

O bônus é um custo para você: é o que você paga acima do mercado para ter suas posições vendidas fechadas rapidamente.

Use essa janela para corrigir a conta por conta própria:

• Deposite colateral
• Feche posições, principalmente opções vendidas
• Cancele ordens que aumentam o risco

Escalada para liquidação total

Uma conta em PreLiquidation que continua abaixo da meta passa para a liquidação total quando qualquer uma destas condições for verdadeira:

• O patrimônio está negativo.
• Não restam opções vendidas para a liquidação parcial fechar.
• O prazo de escalada expira. O prazo é de 20 minutos após a conta entrar em PreLiquidation.

A janela de 20 minutos também garante que uma marcação ruim e passageira não empurre a conta direto para a liquidação total.

Liquidação total

Em uma conta com margem padrão, a liquidação total entrega o book da conta a um liquidante dentro do motor da Hypercall. A Hypercall primeiro cancela todas as ordens abertas da conta e depois oferece a conta.

• O liquidante precisa levar a conta de volta a MM exigida × 1,05, então ele aporta a margem que falta na conta.
• Se a conta ainda tiver patrimônio positivo, o liquidante paga esse patrimônio a você.
• O liquidante fica com todas as posições e com o caixa da conta.

Se a conta se recuperar antes que um liquidante a assuma, a liquidação total é interrompida e a conta volta a Healthy.

Em uma conta com margem de portfólio, a liquidação parcial descrita acima é a etapa com a qual você deve se planejar. Quando uma conta PM escala, suas ordens abertas são canceladas e suas ordens ficam bloqueadas enquanto ela é processada; esta página vai descrever o restante dessa etapa assim que ela estiver finalizada.

Perdas além do patrimônio

Uma perda além do patrimônio de uma conta nunca é coberta fechando posições de outros traders; a Hypercall não tem auto-deleveraging. Quem absorve a perda depende do modo de margem.

Margem padrão. O liquidante assume as posições e o caixa da conta como estão, incluindo o déficit. Um rombo de patrimônio negativo fica com o liquidante.

Margem de portfólio. O que a conta ainda deve após a liquidação (empréstimos do pool e pagamentos de vencimento não quitados) segue uma cascata fixa:

1. O colateral do tomador. A Hypercall cobra do colateral da conta na HyperCore. Veja recuperação. Um empréstimo só é baixado depois que a cobrança se esgota.
2. A reserva de primeira perda. Ela paga primeiro as contas às quais o tomador ainda deve pagamentos de vencimento, do lote mais antigo para o mais novo, e depois cobre o empréstimo baixado.
3. Credores do pool. O que a reserva não cobrir reduz o preço da cota do pool.

A dívida não é perdoada. O que for recuperado do tomador depois paga primeiro as contrapartes de settlement ainda devidas, começando pelo lote mais antigo, e em seguida qualquer empréstimo do pool em aberto; só o restante vai para a reserva e para os credores, na proporção do que cada um perdeu. A reserva de primeira perda cobre apenas empréstimos PM; não existe um fundo de seguro para toda a plataforma.

Endpoints da API

Consultar status de liquidação

GET /liquidation/status?wallet=0x...

data é null para uma conta que nunca saiu de Healthy.

Resposta:

{
  "success": true,
  "data": {
    "wallet": "0x...",
    "state": "pre_liquidation",
    "liquidation_mode": "partial",
    "margin_mode": "portfolio",
    "equity": "4500.00",
    "mm_required": "5000.00",
    "maintenance_margin": "-500.00",
    "shortfall": "500.00",
    "partial_liquidation": {
      "entered_at": 1737312000000,
      "target_equity": "5250.00",
      "mm_shortfall": "500.00",
      "escalation_deadline": 1737313200000,
      "bonus_bps": 50
    },
    "full_liquidation": null
  }
}

partial_liquidation também lista os IDs das ordens de liquidação abertas. full_liquidation traz os detalhes da assunção da conta, incluindo margin_needed, winner e o bid exigido atual.

Consultar histórico de liquidação

GET /liquidation/history?wallet=0x...&limit=20

Retorna o histórico de transições de estado de uma conta.

Consultar histórico público de liquidações

GET /liquidations?limit=50

Retorna o histórico de transições de liquidação de todas as carteiras, do mais recente para o mais antigo. O endpoint é público e usa paginação por cursor para bots liquidantes e ferramentas de monitoramento.

Parâmetros de consulta

• cursor: Cursor opaco retornado pela página anterior.
• limit: Tamanho da página, padrão 50, máximo 100.
• wallet: Filtro opcional por carteira.
• status ou state: Filtro opcional pelo estado da transição de liquidação. Valores aceitos: healthy, pre_liquidation, in_liquidation e liquidated.
• margin_mode: Filtro opcional pelo modo de margem. Valores aceitos: standard e portfolio.
• liquidation_mode: Filtro opcional pelo modo de liquidação. Valores aceitos: partial e full.

Resposta: PublicLiquidationsResponse com as entradas de transição de liquidação e page.next_cursor para a próxima requisição.

Consultar detalhes do leilão

GET /liquidation/auction/{auction_id}

Retorna o status, as posições e os detalhes de liquidação financeira da liquidação total.

Notificações via WebSocket

Mudanças de estado de liquidação são transmitidas no canal liquidation:

{
  "type": "LiquidationStateChange",
  "wallet_address": "0x...",
  "previous_state": "healthy",
  "new_state": "pre_liquidation",
  "liquidation_mode": "partial",
  "margin_mode": "portfolio",
  "equity": "4500.00",
  "mm_required": "5000.00",
  "maintenance_margin": "-500.00",
  "shortfall": "500.00",
  "partial_liquidation": { "escalation_deadline": 1737313200000, "bonus_bps": 50 },
  "full_liquidation": null,
  "timestamp": 1737312000000
}

partial_liquidation e full_liquidation trazem os mesmos campos do endpoint de status. Faça a assinatura para receber atualizações em tempo real da sua carteira.

Parâmetros

Parâmetro	Valor	Descrição
Intervalo de verificação de saúde	5 segundos	Frequência com que a saúde da conta é verificada
Meta de recuperação	MM exigida × 1,05	Patrimônio (PM) ou caixa (SM) necessário para voltar a Healthy, e o nível que a liquidação total restaura
Déficit mínimo	0	Qualquer déficit inicia a liquidação parcial
Bônus de liquidação	0,5% subindo até 10% ao longo de 5 minutos	Prêmio sobre o preço de referência nas ordens de liquidação parcial
Intervalo de reprecificação	5 segundos	Frequência com que as ordens de liquidação parcial são reprecificadas
Prazo de escalada	20 minutos	Tempo em PreLiquidation antes do início da liquidação total

Boas práticas

Para traders

1. Acompanhe o índice de margem: mantenha o patrimônio bem acima da MM (recomendamos um buffer de 2x)
2. Configure alertas: use o WebSocket para detectar a pré-liquidação com antecedência
3. Tenha caixa disponível: mantenha colateral de reserva pronto para depositar
4. Feche as posições vendidas você mesmo: você não paga bônus de liquidação nas ordens que envia

Consultando a saúde da conta

Verifique seu status de margem regularmente:

curl "https://api.hypercall.xyz/portfolio?wallet=0x..."

# Look for:
# - span_margin.equity vs span_margin.maintenance_margin_required (portfolio)
# - margin_summary.standard_margin.maintenance_margin_headroom (standard)

---

Veja também:

• Margem de portfólio: cálculo da MM para contas de portfólio
• Margem padrão: cálculo da MM para contas padrão
• Piso de margem: pisos de segurança que afetam o limite de liquidação
• Financiamento de PM: como a dívida de PM é cobrada
• Parâmetros de risco de PM: o índice de MM e todas as outras configurações de PM em vigor
• Simulando o risco de PM: verifique a folga de MM em um book hipotético