Apalancamiento en Hyperliquid: Niveles de Margen, Cruzado vs Aislado y Mecánica de Liquidación

Alcance y la respuesta directa

En Hyperliquid, el apalancamiento es una configuración por posición limitada por dos cosas: el apalancamiento máximo configurado para ese mercado perpetuo y el nivel de margen que se aplica al valor nocional de tu posición. Puedes establecer el apalancamiento en cualquier número entero desde 1 hasta el máximo del mercado, pero el máximo en sí está escalonado: las posiciones más grandes se ven empujadas a niveles de menor apalancamiento con requisitos de margen de mantenimiento más altos. No existe una única cifra de 'apalancamiento en Hyperliquid'; cifras como 40x o 50x que circulan en línea se refieren a mercados específicos en tamaños de posición específicos, y cambian a medida que cambian los niveles y los listados.

Este artículo cubre el mecanismo (margen inicial, margen de mantenimiento, niveles), la diferencia entre margen cruzado y aislado, y un procedimiento ejecutable para verificar límites y distancia a la liquidación con datos en vivo del protocolo. No recomienda un nivel de apalancamiento; el dimensionamiento es tu decisión de riesgo.

• Configuración de apalancamiento: entero de 1 al apalancamiento máximo del mercado.
• Apalancamiento máximo: depende del activo y del nivel nocional en el que cae tu posición.
• Margen de mantenimiento: derivado de la tasa de margen de mantenimiento del nivel, no de tu apalancamiento elegido.
• Cruzado vs aislado: cambia qué colateral puede absorber pérdidas y cuándo se activa la liquidación.

Supuestos y requisitos previos

El procedimiento a continuación asume que tienes una cuenta de Hyperliquid financiada con USDC, una forma de llamar al endpoint de información público (cualquier cliente HTTP sirve) y familiaridad básica con la terminología de futuros perpetuos. No necesitas una clave API para leer metadatos del mercado; sí necesitas tratar cualquier URL de endpoint como configuración en lugar de algo codificado, porque los endpoints públicos y los límites de tasa varían según el proveedor.

Si estás eligiendo un proveedor de RPC o API para un bot de trading en lugar de leer metadatos manualmente, la decisión concreta del endpoint corresponde a RPC Assistant — consulta la guía sobre el mejor proveedor de RPC para Hyperliquid y endpoints de trading de baja latencia. Esta página se centra en la mecánica del protocolo.

Modelo mental: margen inicial, margen de mantenimiento y niveles

El margen inicial es lo que debes depositar para abrir una posición con el apalancamiento elegido: con apalancamiento de L veces, el margen inicial es aproximadamente el nocional dividido por L. El margen de mantenimiento es el capital mínimo que debes mantener; si el capital cae por debajo, la posición se vuelve liquidable. Ambos no son simétricos, y la diferencia entre ellos es tu colchón.

Hyperliquid utiliza una fórmula de margen de mantenimiento por niveles de la forma maintenance_margin = notional_position_value × maintenance_margin_rate − maintenance_deduction. La tasa de margen de mantenimiento en un nivel es la mitad de la tasa de margen inicial implícita por el apalancamiento máximo de ese nivel — por ejemplo, un nivel limitado a 20x implica una tasa de margen inicial del 5% y una tasa de margen de mantenimiento del 2.5%. La deducción de mantenimiento existe para que el margen de mantenimiento total sea continuo a medida que el tamaño de la posición cruza los límites de nivel: cada nuevo nivel agrega margen a su propia tasa en lugar de recalcular retroactivamente toda la posición.

La consecuencia práctica: a medida que tu nocional crece, el apalancamiento máximo disponible para ti disminuye, y tu requisito de mantenimiento aumenta más rápido de lo que sugeriría un porcentaje plano. Una posición que es cómoda en un tamaño puede ser empujada a un nivel más estricto solo agregando tamaño, sin ningún movimiento de precio.

• El nivel 0 tiene deducción de mantenimiento cero.
• La deducción de cada nivel posterior tiene en cuenta las tasas más bajas aplicadas a los niveles anteriores.
• Las tablas de margen tienen ID; para ID menores a 50, la tabla es un solo nivel cuyo apalancamiento máximo es igual al ID.
• La tasa de margen de mantenimiento depende del nivel, no del activo — el activo determina qué tabla se aplica.

Lectura de los límites de apalancamiento autorizados desde el endpoint de información

Las tablas de niveles de margen y el apalancamiento máximo por activo se publican en la respuesta de meta información del protocolo, por lo que debes leerlas en lugar de confiar en resúmenes de terceros. La siguiente llamada curl obtiene metadatos del mercado perpetuo; sustituye el endpoint de tu proveedor por RPC_URL. La respuesta incluye el nombre de cada activo, los decimales de tamaño y el apalancamiento máximo, además de los identificadores de tabla de margen que puedes cruzar con las tablas de niveles publicadas.

Ejecuta esto antes de dimensionar cualquier posición y vuelve a ejecutarlo después de que cambien los listados. Trata la salida como la fuente de verdad para el mercado que estás a punto de operar.

curl -s -X POST "$RPC_URL" \
  -H 'Content-Type: application/json' \
  -d '{"type":"meta"}' \
  | python3 -c "import sys,json; d=json.load(sys.stdin); [print(a['name'], a.get('maxLeverage'), a.get('marginTableId')) for a in d['universe']]"

Resultado de verificación esperado

Una llamada exitosa devuelve un objeto JSON con un arreglo universe. Cada entrada debe mostrar un nombre de activo, un valor maxLeverage y un marginTableId cuando corresponda. Si maxLeverage falta para un activo, es probable que ese activo esté deslistado o no sea un perpetuo — verifica la bandera isDelisted antes de operarlo.

Registra el maxLeverage para tu mercado objetivo y el marginTableId. Luego busca los niveles de esa tabla en la documentación publicada de niveles de margen. Tu apalancamiento máximo efectivo es el apalancamiento máximo del nivel en el que cae tu nocional previsto, que puede ser menor que el maxLeverage destacado para el activo.

• Activo presente, maxLeverage numérico: el mercado está activo y el límite destacado es conocido.
• marginTableId presente: se aplica un esquema por niveles; verifica los rangos nocionales.
• isDelisted verdadero: no dimensiones una posición con metadatos obsoletos.

Margen cruzado vs margen aislado y qué hace cada uno con la liquidación

En margen cruzado, todo el capital de tu cuenta respalda tus posiciones. Las pérdidas en una posición pueden recurrir al colateral que de otro modo respaldaría otra, lo que reduce la probabilidad de liquidación de una sola posición pero aumenta la probabilidad de que una mala posición afecte a toda la cuenta. En margen aislado, a cada posición se le asigna su propio colateral; una liquidación se limita al margen de esa posición y el resto de la cuenta queda aislado.

Por lo tanto, el precio de liquidación es una función del modo de margen, no solo del apalancamiento. En margen aislado, el precio de liquidación está determinado por el requisito de mantenimiento de la propia posición y el colateral asignado. En margen cruzado, depende del capital total de la cuenta en relación con el margen de mantenimiento agregado, por lo que agregar una posición no relacionada puede mover tu precio de liquidación incluso si el tamaño y la entrada de la primera posición no cambian.

Un diagnóstico útil es calcular la distancia desde el precio de marca hasta el precio de liquidación como porcentaje y luego compararla con la volatilidad reciente del mercado. Un colchón del 2% no es equivalente entre activos.

• Aislado: liquidación contenida en la posición; más simple de razonar para el riesgo por operación.
• Cruzado: eficiente en capital pero con contagio a toda la cuenta; la liquidación depende del capital agregado.
• Cambiar de modo cambia el precio de liquidación sin cambiar el precio de entrada ni el tamaño.

Cálculo del apalancamiento efectivo y la distancia a la liquidación en código

El siguiente fragmento de Python lee el estado de tu cámara de compensación y calcula el apalancamiento efectivo y una distancia aproximada a la liquidación por posición. Utiliza marcadores de posición para el endpoint y la dirección de la cuenta; no coloca órdenes. El apalancamiento efectivo aquí es el nocional de la posición dividido por el margen realmente comprometido, que puede diferir del número entero de apalancamiento que estableciste debido a la PnL no realizada y las comisiones.

Ejecútalo primero en una cuenta de prueba o pequeña. La salida es un diagnóstico, no una garantía: el precio de liquidación también depende de la acumulación de financiamiento y del comportamiento del motor de liquidación del exchange.

import json, urllib.request

RPC_URL = "RPC_URL"
ACCOUNT = "0xYOUR_ACCOUNT_ADDRESS"

req = urllib.request.Request(
    RPC_URL,
    data=json.dumps({"type": "clearinghouseState", "user": ACCOUNT}).encode(),
    headers={"Content-Type": "application/json"},
)
state = json.load(urllib.request.urlopen(req))

for p in state.get("assetPositions", []):
    pos = p["position"]
    szi = float(pos["szi"])
    entry = float(pos["entryPx"])
    liq = pos.get("liquidationPx")
    margin = float(pos["marginUsed"])
    notional = abs(szi) * entry
    eff_lev = notional / margin if margin else float("inf")
    dist = (abs(float(liq) - entry) / entry * 100) if liq else None
    print(pos["coin"], f"eff_lev={eff_lev:.2f}x", f"liq_dist={dist:.2f}%" if dist else "liq=n/a")

Procedimiento de diagnóstico y tabla de resultados

Utiliza este procedimiento para comparar tamaños de posición candidatos antes de abrirlos. Produce una tabla que llenas con valores que realmente observas; no copies números de ningún artículo, incluido este, porque los niveles y los precios cambian.

Paso 1: obtén meta y registra maxLeverage y marginTableId para el mercado. Paso 2: busca el rango de nivel que contiene tu nocional previsto y registra el apalancamiento máximo de ese nivel. Paso 3: elige un número entero de apalancamiento igual o inferior a ese máximo de nivel. Paso 4: calcula el margen inicial como nocional dividido por el apalancamiento elegido. Paso 5: calcula el margen de mantenimiento usando la fórmula del nivel. Paso 6: calcula el movimiento adverso de precio que llevaría el capital al margen de mantenimiento. Paso 7: repite para un tamaño arriba y uno abajo para ver dónde muerden los límites de nivel.

Registra los resultados en una tabla como la siguiente. Las columnas son fijas; los valores son tuyos para medir.

• | Mercado | Nocional previsto (USDC) | Apalancamiento máximo del nivel | Apalancamiento elegido | Margen inicial | Margen de mantenimiento | Movimiento adverso hasta liquidación |
• | BTC | (medido) | (de meta + niveles) | (1..máx nivel) | nocional / apalancamiento | fórmula del nivel | (medido) |
• | ETH | (medido) | (de meta + niveles) | (1..máx nivel) | nocional / apalancamiento | fórmula del nivel | (medido) |

Solución de problemas comunes de apalancamiento y margen

La mayoría de las sorpresas de apalancamiento en Hyperliquid provienen de cuatro fuentes: metadatos obsoletos, límites de nivel, cambios de modo de margen y acumulación de financiamiento. Revísalos en ese orden.

Si tu orden es rechazada por margen insuficiente, vuelve a obtener meta y confirma el apalancamiento máximo actual del mercado y tu nivel — una actualización de listado o un aumento de tamaño puede reducir el límite. Si tu precio de liquidación parece incorrecto, confirma si la posición es cruzada o aislada; cambiar de modo lo recalcula. Si tu apalancamiento efectivo se desvía de tu configuración, verifica la PnL no realizada y las comisiones, que cambian el margen usado sin cambiar el tamaño de la posición. Si una posición se liquida antes de lo que predijo tu cálculo, verifica los pagos de financiamiento entre tu cálculo y el evento.

• Vuelve a obtener meta después de cualquier cambio de listado o nivel.
• Confirma el modo de margen antes de comparar precios de liquidación entre sesiones.
• Ten en cuenta el financiamiento en tenencias de varios días.
• Verifica que el marginTableId se corresponda con la tabla de niveles que usaste.

Limitaciones y compensaciones

El apalancamiento por niveles protege al protocolo pero complica el dimensionamiento de posiciones: el apalancamiento disponible para ti es una función del tamaño, por lo que escalar puede reducir silenciosamente tu apalancamiento máximo permitido y aumentar tu requisito de mantenimiento. El margen cruzado es eficiente en capital pero hace que el riesgo a nivel de cuenta sea más difícil de aislar. El margen aislado es más fácil de razonar pero inmoviliza colateral por posición.

Las fórmulas aquí describen el comportamiento documentado del protocolo; no modelan detalles del motor de liquidación, interacciones con el fondo de seguros ni impacto de mercado durante movimientos rápidos. Cualquier medición que tomes es una instantánea. Para sistemas en producción, trata los metadatos como almacenables en caché pero actualizables, y trata el precio de liquidación como una estimación que el exchange calcula de manera autorizada.

Si estás construyendo infraestructura de trading automatizado, la confiabilidad y la latencia del endpoint importan tanto como los cálculos de margen. El servicio RPC de Hyperliquid de OnFinality y las opciones de nodo dedicado son los lugares para evaluar esa capa; la elección concreta del proveedor es una cuestión de RPC Assistant, no del protocolo.

Próximos pasos

Una vez que puedas leer meta y el estado de la cámara de compensación de manera confiable, los siguientes pasos útiles son automatizar la búsqueda de niveles para que tu código de dimensionamiento siempre use los límites actuales, registrar el apalancamiento efectivo y la distancia a la liquidación por ejecución, y probar los cambios de modo de margen en una cuenta pequeña antes de depender de ellos.

Para el lado de la infraestructura, revisa la página de la red Hyperliquid, compara los precios de RPC y lee la guía de endpoints de trading de baja latencia antes de comprometer un bot con un proveedor. Si necesitas un nodo dedicado para un rendimiento constante, esa opción existe por separado del RPC compartido.

• Automatiza la búsqueda de niveles en tu ruta de dimensionamiento.
• Registra el apalancamiento efectivo y la distancia a la liquidación por posición.
• Valida el comportamiento del modo de margen en una cuenta pequeña.
• Elige la infraestructura deliberadamente: /en/networks, /en/pricing/rpc, /en/dedicated-node.