Errores de Hyperliquid

Hyperliquid es un exchange descentralizado, y sus errores funcionan de forma distinta a los del resto. No hay códigos numéricos: cuando rechaza algo, el exchange responde con una frase en inglés, por ejemplo Order must have minimum value of $10. Tampoco tiene API keys en el sentido habitual: la conexión firma las órdenes con la clave privada de la wallet o de la API-wallet, y el límite de solicitudes se cuenta por dirección de wallet, no por IP.

Si el terminal no reconoce el rechazo, en el mensaje emergente después de «Order:» aparecerá la respuesta del exchange como HL exchange error: Order must have minimum value of $10. asset=0. Un rechazo de cancelación se ve como «Cancelación rechazada: Hyperliquid cancel …». El proceso general para analizar los errores está en Mensajes de error: cómo leerlos, y la configuración de la conexión, en Conexión de exchanges y API keys.

Qué explica el terminal por sí mismo

Situación	Respuesta del exchange	Qué verás
El exchange no conoce ninguna wallet con esa clave	«User or API Wallet 0x… does not exist.»	Etiqueta «…: el exchange rechazó la API key o el secret; revísalos en la configuración de la conexión», y en la conexión, en Configuración → Conexiones, la indicación «El exchange rechazó la API key o el secret»
Clave de API-wallet cuando su soporte está desactivado	—	«…: este tipo de clave no es compatible. Para Hyperliquid se necesita la clave privada de la propia wallet, no la de la API-wallet (agent)»
Límite de solicitudes de la dirección agotado en tu acción	HTTP 429	«Hyperliquid: límite de solicitudes (429), pausa de ~… s — hasta … UTC. El presupuesto de solicitudes de la dirección se repone con volumen negociado (1 solicitud por 1 USDC).»
Lo mismo en una consulta en segundo plano	HTTP 429	Nada: el terminal espera la pausa en silencio
La comisión del builder de LootX no está aprobada	«Builder fee has not been approved»	Nada: el terminal reenvía de inmediato la misma orden sin comisión del builder
El saldo está en la parte spot de la cuenta unificada	—	El terminal muestra ese saldo como margen de futuros. Más detalles abajo
Stop en corto sin posición abierta	—	Entrada en el registro: «Hyperliquid: un stop en corto sin posición abierta el exchange lo ejecutará como reduce-only y lo rechazará». La orden se envía igualmente

Frases frecuentes

Hyperliquid no tiene códigos: la causa la indica la frase del exchange, así que en la tabla figura esa frase en lugar de un código. Todas estas frases aparecen como texto del exchange en el mensaje de la orden.

Respuesta del exchange	Causa	Qué hacer
«Order must have minimum value of $10.»	El importe de la orden de futuros es inferior a 10 USDC	Aumenta el volumen
«Order must have minimum value of 10 …»	Lo mismo en spot: el importe es inferior a 10 unidades de la moneda cotizada	Aumenta el volumen
«Insufficient margin to place order.»	Falta margen teniendo en cuenta el apalancamiento y las posiciones abiertas	Reduce el volumen o el apalancamiento, o recarga la cuenta; consulta Saldo en cero o margen incorrecto
«(Spot-only) Order has insufficient spot balance to trade»	En spot faltan monedas o USDC	Reduce el volumen o retira órdenes sobrantes
«Reduce only order would increase position.»	La orden de cierre aumentaría la posición: no hay posición o está en el sentido contrario	Revisa la posición. Hyperliquid considera un stop en corto sin posición como orden de cierre; consulta Qué explica el terminal por sí mismo
«Price must be divisible by tick size.»	El precio no respeta el paso de precio de la moneda	Ajusta el precio a la cuadrícula del libro de órdenes
«Order price too far from oracle»	El precio está demasiado lejos del precio del oráculo	Coloca la orden más cerca del mercado
«Post only order would have immediately matched, bbo was …»	Una orden «solo maker» se ejecutaría de inmediato	Aleja el precio de la mejor contrapartida
«Order could not immediately match against any resting orders.»	Una orden «ejecutar de inmediato» no encontró órdenes en reposo	Reinténtalo o coloca una orden límite
«No liquidity available for market order.»	No hay liquidez en el libro de órdenes para una orden de mercado	Usa una orden límite
«Invalid TP/SL price.»	El precio de activación del stop no está en el lado correcto del mercado	Revisa el precio del stop
«Order would cause position to exceed margin tier limit at current leverage»	La posición superaría el límite del nivel de margen para el apalancamiento actual	Reduce el volumen o el apalancamiento
«Order would increase open interest while open interest is capped»	Se alcanzó el límite de interés abierto de la moneda	Espera a que se libere el límite o limítate a cerrar la posición

Cómo resolver los problemas frecuentes

El exchange rechazó la clave

La conexión de Hyperliquid tiene un único campo: Private Key / Seed: la clave privada 0x… o la frase semilla. El rechazo «User or API Wallet 0x… does not exist.» significa que Hyperliquid no encontró ninguna cuenta para la dirección derivada de tu clave.

Revisa la clave

Pega la clave completa de nuevo, sin espacios en los extremos. Un error en un solo carácter genera otra dirección: ajena y vacía.

Comprueba que la wallet tiene cuenta en Hyperliquid

Si es la clave de la wallet principal, debe haberse hecho un depósito en Hyperliquid con esa wallet; sin depósito, el exchange no crea la cuenta.

Si es una API-wallet, comprueba que sigue activa

Abre la sección API en el sitio de Hyperliquid y verifica que la API-wallet no esté eliminada. Si lo está, crea una nueva y pega su clave privada.

Clave de API-wallet (agent)

En el sitio de Hyperliquid puedes crear una API-wallet: una clave separada que opera en nombre de la wallet principal, pero no puede retirar fondos. Esa clave se puede pegar en Private Key / Seed: el terminal preguntará al exchange a qué wallet principal pertenece y mostrará el saldo, las posiciones y las órdenes de esa wallet.

Mientras el exchange no responda de quién es la clave, el terminal no muestra la posición ni el saldo y repite la pregunta; de lo contrario, leería la cuenta vacía de la propia API-wallet y mostraría ceros.

El mensaje «este tipo de clave no es compatible» aparece únicamente si la aceptación de claves de API-wallet está temporalmente desactivada por parte de LootX. En ese caso, pega la clave privada de la wallet principal. Más detalles en Mensajes del terminal.

Comisión del builder

El terminal añade la comisión del builder de LootX a las órdenes de Hyperliquid. La aprueba una sola vez con la firma de la wallet principal; con la clave de la wallet principal, el terminal lo hace automáticamente.

La clave de una API-wallet no puede firmar esa aprobación, y sin depósito en la wallet el exchange no la aceptará. En ambos casos las órdenes se envían igualmente, solo que sin la comisión del builder. Si el exchange rechaza una orden por la comisión no aprobada, el terminal la reenvía de inmediato sin comisión y no verás el rechazo. No tienes que hacer nada.

Saldo en cero o margen incorrecto

Por defecto, la cuenta de Hyperliquid es unificada: el dinero de spot y el de futuros están juntos, y el exchange lo muestra en la parte spot. El terminal lo tiene en cuenta: si el margen de futuros es cero y hay USDC en spot, toma el saldo de spot.

Si en Hyperliquid tienes activado el modo manual con saldos separados, aparece una imprecisión: si la parte de futuros está vacía, el terminal mostrará los USDC de spot como margen disponible y el exchange rechazará la orden con «Insufficient margin to place order.». Transfiere USDC de spot a futuros en el sitio de Hyperliquid.

Límite de solicitudes de la dirección

En Hyperliquid, el presupuesto de solicitudes se cuenta por dirección de wallet y no se repone con el tiempo, sino con el volumen negociado: 1 solicitud por 1 USDC negociado, como indica la etiqueta. Cuando el presupuesto se agota, el exchange responde 429. El terminal muestra la etiqueta únicamente cuando el límite afectó a tu acción (colocar o cancelar una orden); en las consultas en segundo plano, simplemente las ralentiza.

El spot y los futuros de una misma wallet comparten el presupuesto. Cambiar de IP o de proxy normalmente no ayuda: el límite está vinculado a la dirección. Espera a que termine la pausa; el presupuesto se repone a medida que operas.

Mercados HIP-3

Además de los futuros principales, Hyperliquid tiene mercados HIP-3: contratos lanzados por exchanges deployer externos, con nombres como xyz:AAPL. Se operan mediante una conexión con Futuros activado. Muchos de estos mercados solo admiten margen aislado. Al cambiar el apalancamiento, el terminal no cambia por sí solo el modo de margen de la moneda: en un mercado «solo aislado» usa margen aislado; si el modo es conocido, lo conserva; y si no pudo leer el modo, para HIP-3 elige aislado. Hyperliquid no permite cambiar el modo de margen con una posición abierta: si el apalancamiento no cambia, lee el texto de la etiqueta «Apalancamiento … ×… no modificado: …».

Mensajes de error

Dónde muestra el terminal los errores y cómo leerlos.

Conexión de exchanges

Cómo añadir una conexión y pegar la clave de la wallet.

Errores de Aster

Dos métodos de firma, wallet y Account Id, baneo por IP.