¿Por qué Hyperliquid rechazó mi orden?
Verificado el con Hyperliquid docs: Error responses y Hyperliquid docs: Order types · por Hyperliquid Academy
Los rechazos son concretos, y eso es una buena noticia
Aquí no hay nada intermitente ni misterioso. El exchange devuelve un motivo con nombre para cada orden rechazada, y cada uno tiene una única corrección.
Si opera por la interfaz verá un mensaje; por la API recibe además el nombre del error. Esta página cubre todos.
Los once motivos
| Lo que ve | Qué significa | La corrección |
|---|---|---|
| El precio debe ser divisible por el tick size | Su precio está entre dos incrementos válidos | Redondear a un tick válido |
| La orden debe tener un valor mínimo de $10 | Nocional del perpetuo por debajo del piso | Aumentar el tamaño |
| La orden debe tener un valor mínimo de 10 tokens de cotización | Orden spot por debajo del piso en el token de cotización | Aumentar el tamaño |
| Margen insuficiente para colocar la orden | No hay suficiente colateral libre | Liberar margen o reducir tamaño |
| La orden reduce-only aumentaría la posición | Lado invertido, o ya no queda posición que reducir | Revisar el lado y la posición |
| La orden post-only se habría ejecutado de inmediato | Una orden ALO que cruzaría | Mover al lado pasivo |
| La orden no pudo ejecutarse de inmediato | Una IOC no encontró contraparte en el libro | Usar una orden límite normal |
| Precio de TP/SL inválido | Disparador del lado equivocado del mercado | Stop debajo en un largo, encima en un corto |
| No hay liquidez para la orden de mercado | El libro no puede llenarla | Reducir tamaño, o usar límite |
| Precio de la orden demasiado lejos del oráculo | Fuera de la banda permitida alrededor del oráculo | Revisar si hay un decimal mal puesto |
| Excedería el límite del nivel de margen con el apalancamiento actual | Posición demasiado grande para este apalancamiento | Bajar apalancamiento o tamaño |
Los cinco que explican casi todos
Tick size
Cada mercado tiene un incremento mínimo de precio, y varía entre mercados. Un precio entre dos incrementos se rechaza, no se redondea.
Por la aplicación esto casi no pasa, porque el ticket redondea por usted. Por API pasa constantemente, porque su código no lo hace. El incremento viene en los metadatos del mercado: léalo en lugar de suponer una cantidad de decimales.
El valor mínimo de orden
$10.00 de nocional en perpetuos, o diez unidades del token de cotización en spot.
Es un umbral de nocional, así que la cantidad de monedas que le corresponde se mueve con el precio. Un tamaño que funcionaba la semana pasada puede quedar por debajo del piso hoy tras una caída.
Margen insuficiente
La causa obvia es una cuenta vacía. Las dos no obvias atrapan a más gente.
Las órdenes en el libro reservan margen. Las órdenes abiertas sin ejecutar pueden retener colateral, así que una cuenta que parece libre no lo está. Cancele lo que no esté usando.
Qué saldo cuenta depende del modo de su cuenta. En modo estándar, lo que da margen a un perpetuo es el saldo de Perps, y el USDC que está en spot no cuenta.
Reduce-only aumentaría la posición
Las órdenes reduce-only solo pueden encoger. El rechazo significa que la suya no lo habría hecho.
Dos causas: el lado está invertido — una compra reduce-only contra un largo es un aumento — o la posición ya está cerrada, así que cualquier orden ahora abre una nueva.
Este rechazo es el flag haciendo su trabajo. Sin él, esa misma orden habría abierto una posición en sentido contrario.
Post-only se habría ejecutado
El flag ALO significa “rechazar en vez de tomar”. Si su precio cruza el spread, ese es exactamente el caso que rechaza.
El error informa el mejor bid y ask de ese momento, que le dice cuánto exactamente moverse. Si en realidad quería la ejecución, quite el flag y acepte la comisión de taker.
Los tres más sutiles
Precio demasiado lejos del oráculo. Hay una banda alrededor del precio del oráculo y su límite quedó fuera. Es una protección contra errores de tipeo, y cuando salta la causa suele ser un decimal, no una opinión de mercado.
No hay liquidez para la orden de mercado. El libro no puede llenar su tamaño a ningún precio que esté dispuesto a aceptar. En un mercado delgado, esto es el exchange negándose a darle una ejecución pésima. Reduzca el tamaño o repártalo en el tiempo.
Excedería el límite del nivel de margen. El apalancamiento máximo baja a medida que la posición crece, así que el tope que aplicaba a su primera parte no aplica al total. Baje el apalancamiento o el tamaño — la tabla está en la guía de apalancamiento.
Rechazos que no son rechazos
Dos cosas se reportan como fallas y no lo son.
Una IOC que no ejecutó nada. Immediate-or-cancel hizo exactamente lo que dice su nombre. No hay nada mal; no había con qué cruzar.
Un stop que no se ha disparado. Una orden disparadora esperando en la columna TP/SL está esperando, no fallando. Envía una orden cuando el precio llega al nivel, y hasta entonces no hace nada.
Si no encaja ninguno
Revise lo obvio en este orden: la conexión está viva y la dirección es la que usted cree; está en el mercado que quería; el modo de cuenta es el que supone. Los problemas de conexión se presentan como una interfaz muerta y no como un error, y por eso es fácil confundirlos con un rechazo.
Adónde ir después
Todos los tipos de órdenes y sus flags, que es la referencia detrás de casi toda esta página, y el resto de la sección de problemas, organizada por síntoma.
Preguntas frecuentes
¿Por qué dice que el precio debe ser divisible por el tick size?
Cada mercado tiene un incremento mínimo de precio y el suyo quedó entre dos de ellos. Redondee a un tick válido; en la aplicación esto se hace por usted, y un precio escrito a mano o enviado por API no.
¿Cuál es el tamaño mínimo de orden?
Diez dólares de nocional en perpetuos, o diez unidades del token de cotización en spot. Por debajo la orden se rechaza entera, no se acepta parcialmente.
¿Por qué se rechaza mi orden reduce-only?
Habría aumentado la posición en lugar de reducirla. Normalmente el lado está invertido, o la posición ya se cerró y la orden abriría una nueva en sentido contrario.
¿Por qué falló mi orden post-only?
Se habría ejecutado de inmediato contra el libro, que es precisamente lo que post-only prohíbe. Mueva el precio al lado pasivo del spread. El error informa el mejor bid y ask de ese momento.
¿Qué significa 'precio demasiado lejos del oráculo'?
Su precio límite quedó fuera de la banda que el exchange permite alrededor del precio del oráculo. Es una protección contra errores de tipeo, y salta sobre todo en mercados delgados o con un decimal mal puesto.
¿Por qué no puedo aumentar más la posición?
Niveles de margen. El apalancamiento máximo baja a medida que la posición crece, así que un tamaño válido con su apalancamiento deja de serlo pasado el umbral. Baje el apalancamiento o el tamaño.
Fuentes
- Hyperliquid docs: Error responseshyperliquid.gitbook.io
- Hyperliquid docs: Order typeshyperliquid.gitbook.io
Enlazamos la fuente primaria de cada número de esta página. Si una cifra de aquí contradice la documentación de Hyperliquid, la documentación tiene razón y queremos saberlo.