Liquidación

La liquidación protege al sistema frente a cuentas que ya no pueden cumplir sus obligaciones de margen. Cuando el equity de una cuenta cae por debajo de su requisito de margen de mantenimiento, Hypercall primero intenta sanear la cuenta cerrando opciones short. Si eso no funciona a tiempo, la cuenta escala a liquidación total.

Condiciones de activación

La liquidación se activa cuando una cuenta queda en déficit (underwater):

Margen de cartera (Portfolio Margin):

$$\text{Equity} < \text{Margen de mantenimiento requerido}$$

Margen estándar (Standard Margin):

$$\text{Efectivo} < \text{MM requerido}$$

La liquidación en SM se determina por el margen disponible de mantenimiento en efectivo (cash - mm_required), no por el equity, de modo que las marcas de opciones long que aumentan el NAV no evitan un déficit de efectivo. El campo de la API maintenance_margin = equity - mm_required se sigue reportando, pero no es el disparador de liquidación en SM. Consulte Margen estándar.

Para una cuenta con margen de cartera, el equity es neto de cualquier monto adeudado al pool de préstamos de PM, y el requisito de mantenimiento también tiene en cuenta la liquidación que el propio Hyperliquid realiza de sus perpetuos en HyperCore. Hyperliquid puede seguir liquidando esos perpetuos según sus propias reglas, de forma independiente de Hypercall. Consulte Margen de cartera.

Hypercall verifica el estado de cada cuenta con posiciones cada 5 segundos.

Estados

Estado	Qué está ocurriendo	Órdenes
Healthy	PM: equity igual o superior al MM requerido. SM: efectivo igual o superior al MM requerido.	Se permiten todas las órdenes
PreLiquidation	Liquidación parcial: Hypercall coloca órdenes de cierre sobre las opciones short de la cuenta	Solo órdenes que reducen una posición existente
InLiquidation	Liquidación total. Margen estándar: el libro de la cuenta se ofrece a un liquidador	Solo órdenes que reducen una posición existente
Liquidated	Un liquidador asumió el libro de la cuenta	Solo órdenes que reducen una posición existente

Los retiros y los barridos de efectivo de PM están deshabilitados en PreLiquidation e InLiquidation. Una vez que una cuenta PM se está vaciando para la liquidación total, todas sus órdenes quedan bloqueadas.

Transiciones de estado

1. De Healthy a PreLiquidation: la cuenta cae por debajo de su umbral de MM.
2. De PreLiquidation a Healthy: la cuenta alcanza el objetivo con margen adicional, MM requerido × 1.05, y ninguna de sus órdenes de liquidación sigue abierta. El límite es inclusivo.
3. De PreLiquidation a InLiquidation: la cuenta sigue por debajo del objetivo y se cumple una de las condiciones de escalada indicadas más abajo.
4. De InLiquidation a Healthy: la cuenta se recupera antes de que un liquidador la asuma, y la liquidación total se detiene.
5. De InLiquidation a Liquidated: un liquidador asume la cuenta.

Liquidación parcial

Cuando una cuenta entra en PreLiquidation:

1. Las órdenes que añadirían riesgo se rechazan de inmediato. Las órdenes que reducen una posición existente siguen aceptándose.
2. Hypercall cancela sus órdenes abiertas que añaden riesgo y coloca órdenes de compra reduce-only sobre sus opciones short, dimensionadas para devolver la cuenta a MM requerido × 1.05. Primero cierra las posiciones short que liberan más margen por contrato.
3. Cada orden se cotiza al mejor ask (o al mid, o al bid, si no hay ask) más una bonificación de liquidación. La bonificación comienza en 0.5% y sube linealmente hasta 10% a lo largo de 5 minutos. Las órdenes se recotizan cada 5 segundos.
4. En cuanto la cuenta vuelve a estar igual o por encima del objetivo y las órdenes de liquidación han desaparecido, regresa a Healthy.

La bonificación es un costo para usted: es lo que paga por encima del mercado para que sus posiciones short se cierren rápidamente.

Aproveche este intervalo para corregir la cuenta usted mismo:

• Deposite colateral
• Cierre posiciones, especialmente opciones short
• Cancele las órdenes que añaden riesgo

Escalada a liquidación total

Una cuenta en PreLiquidation que sigue por debajo del objetivo escala a liquidación total cuando se cumple cualquiera de estas condiciones:

• El equity es negativo.
• No le quedan opciones short que la liquidación parcial pueda cerrar.
• Vence el plazo de escalada. El plazo es de 20 minutos después de que la cuenta entró en PreLiquidation.

El intervalo de 20 minutos también implica que una marca errónea momentánea no lleva a una cuenta directamente a la liquidación total.

Liquidación total

Para una cuenta con margen estándar, la liquidación total entrega el libro de la cuenta a un liquidador dentro del motor de Hypercall. Hypercall primero cancela todas las órdenes abiertas de la cuenta y luego ofrece la cuenta.

• El liquidador debe devolver la cuenta a MM requerido × 1.05, por lo que aporta el margen que le falta a la cuenta.
• Si la cuenta todavía tiene equity positivo, el liquidador le paga ese equity a usted.
• El liquidador se queda con todas las posiciones y con el efectivo de la cuenta.

Si la cuenta se recupera antes de que un liquidador la asuma, la liquidación total se detiene y la cuenta regresa a Healthy.

Para una cuenta con margen de cartera, la liquidación parcial descrita arriba es la etapa a tener en cuenta en su planificación. Una vez que una cuenta PM escala, sus órdenes abiertas se cancelan y sus órdenes quedan bloqueadas mientras se procesa; esta página describirá el resto de esa etapa cuando sea definitiva.

Pérdidas superiores al equity

Una pérdida superior al equity de una cuenta nunca se cubre cerrando posiciones de otros traders; Hypercall no tiene auto-deleveraging. Quién la absorbe depende del modo de margen.

Margen estándar. El liquidador toma las posiciones y el efectivo de la cuenta tal como están, déficit incluido. Un déficit por equity negativo queda a cargo del liquidador.

Margen de cartera. Lo que la cuenta aún debe después de la liquidación (préstamos del pool y settlement impagado) pasa por una cascada fija:

1. El colateral del prestatario. Hypercall cobra del colateral de la cuenta en HyperCore. Consulte recuperación. Un préstamo solo se da de baja cuando el cobro se ha agotado.
2. La reserva de primera pérdida. Primero paga a las cuentas a las que el prestatario aún debe settlement, empezando por el lote más antiguo, y después cubre el préstamo dado de baja.
3. Los prestamistas del pool. Lo que la reserva no puede cubrir reduce el precio de la participación del pool.

La deuda no se condona. Lo que se recupere del prestatario más adelante paga primero a las contrapartes de settlement aún pendientes, empezando por el lote más antiguo, y después cualquier préstamo del pool pendiente; solo el resto va a la reserva y a los prestamistas, en proporción a lo que perdió cada uno. La reserva de primera pérdida respalda solo préstamos PM; no hay un fondo de seguro para todo el venue.

Endpoints de la API

Obtener el estado de liquidación

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

data es null para una cuenta que nunca ha salido de Healthy.

Respuesta:

{
  "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 también enumera los IDs de las órdenes de liquidación abiertas. full_liquidation contiene los detalles de la asunción, incluidos margin_needed, winner y la oferta requerida vigente.

Obtener el historial de liquidación

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

Devuelve el historial de transiciones de estado de una cuenta.

Obtener el historial público de liquidaciones

GET /liquidations?limit=50

Devuelve el historial de transiciones de liquidación de todas las wallets, del más reciente al más antiguo. El endpoint es público y usa paginación por cursor para bots liquidadores y herramientas de monitoreo.

Parámetros de consulta

• cursor: cursor opaco devuelto por la página anterior.
• limit: tamaño de página, por defecto 50, máximo 100.
• wallet: filtro opcional por wallet.
• status o state: filtro opcional por estado de transición de liquidación. Los valores aceptados son healthy, pre_liquidation, in_liquidation y liquidated.
• margin_mode: filtro opcional por modo de margen. Los valores aceptados son standard y portfolio.
• liquidation_mode: filtro opcional por modo de liquidación. Los valores aceptados son partial y full.

Respuesta: PublicLiquidationsResponse con las entradas de transición de liquidación y page.next_cursor para la siguiente solicitud.

Obtener los detalles de la subasta

GET /liquidation/auction/{auction_id}

Devuelve el estado, las posiciones y los detalles de liquidación al vencimiento de la liquidación total.

Notificaciones por WebSocket

Los cambios de estado de liquidación se difunden en el 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 y full_liquidation contienen los mismos campos que el endpoint de estado. Suscríbase para recibir actualizaciones en tiempo real de su wallet.

Parámetros

Parámetro	Valor	Descripción
Intervalo de verificación de estado	5 segundos	Con qué frecuencia se verifica el estado de la cuenta
Objetivo de recuperación	MM requerido × 1.05	Equity (PM) o efectivo (SM) necesario para volver a Healthy, y el nivel que restablece una liquidación total
Déficit mínimo	0	Cualquier déficit inicia la liquidación parcial
Bonificación de liquidación	0.5% subiendo hasta 10% en 5 minutos	Prima sobre el precio de referencia en las órdenes de liquidación parcial
Intervalo de recotización	5 segundos	Con qué frecuencia se recotizan las órdenes de liquidación parcial
Plazo de escalada	20 minutos	Tiempo en PreLiquidation antes de que comience la liquidación total

Buenas prácticas

Para traders

1. Monitoree el ratio de margen: mantenga el equity muy por encima del MM (se recomienda un colchón de 2x)
2. Configure alertas: use WebSocket para detectar la preliquidación a tiempo
3. Tenga liquidez disponible: mantenga colateral de reserva listo para depositar
4. Cierre usted mismo sus posiciones short: no paga bonificación de liquidación en las órdenes que coloca usted

Consultar el estado de la cuenta

Verifique su estado de margen con regularidad:

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)

---

Consulte también:

• Margen de cartera: cálculo del MM para cuentas de margen de cartera
• Margen estándar: cálculo del MM para cuentas estándar
• Piso de margen: pisos de seguridad que afectan el umbral de liquidación
• Financiamiento de PM: cómo se cobra la deuda de PM
• Parámetros de riesgo de PM: el ratio de MM y todos los demás ajustes de PM vigentes
• Simulación del riesgo de PM: verifique el margen disponible de MM en un libro hipotético