Un bot de trading de perpetuos de Hyperliquid gestiona exposición a derivados mediante órdenes, ejecuciones y garantía. Comprar un perpetuo no significa adquirir el token al contado correspondiente para retirarlo. El valor de la posición cambia con el contrato, y sus requisitos operativos incluyen el margen, la financiación y la posibilidad de liquidación. Esas características hacen insuficiente por sí mismo un flujo de inventario al contado.
Una automatización fiable comienza con una descripción duradera del cambio previsto en la posición. Después verifica el instrumento y la cuenta, comprueba los recursos aplicables, envía una acción limitada y concilia lo que ocurrió realmente. La estrategia debería seguir comprendiendo sus obligaciones cuando una orden solo se ejecuta parcialmente, una cancelación compite con una operación o el proceso se reinicia.
Esta es educación general sobre los mecanismos de perpetuos, no una afirmación de que un software concreto los admita. Todos los ejemplos numéricos son hipotéticos y solo omiten complejidad cuando se indica expresamente. No se recomienda ningún nivel de apalancamiento, tasa de financiación ni rentabilidad esperada.
Define el ciclo de vida de órdenes del bot de perpetuos de Hyperliquid
El ciclo de vida comienza con un cambio previsto de exposición con signo: aumentar una posición larga, reducir una corta o cerrar un importe especificado, por ejemplo. La intención debería identificar el instrumento, la cuenta, el tamaño máximo, la restricción de precio y la versión de política. Una etiqueta genérica de comprar no describe completamente el objetivo económico.
Mantén distinguibles los resultados de enviado, aceptado, en espera, ejecutado parcialmente, completado y cancelado. Las pruebas exactas de la API determinan qué etiquetas se aplican. Una respuesta satisfactoria de transporte no demuestra por sí misma que toda la cantidad prevista se convirtiera en una posición.
La descripción de ejecución de Hyperliquid explica la importancia de seleccionar la superficie y la cuenta correctas. Para los perpetuos, conecta ese marco con un registro de posiciones en lugar de sustituirlo por un saldo al contado. El registro debe conservar tanto la exposición actual como la exposición adicional que podrían crear las órdenes activas restantes.
Identifica el contrato exacto y la plataforma de negociación
Un símbolo de activo puede aparecer en más de un producto o contexto de mercado. El bot debería identificar el identificador real del perpetuo, la plataforma o el despliegue pertinente, el activo de cotización o garantía y la precisión admitida de tamaño y precio. Un símbolo conocido no es suficiente para construir correctamente una orden.
La documentación actual de Hyperliquid distingue los perpetuos operados por validadores y los mercados HIP-3, entre otras superficies del ecosistema. Los parámetros del contrato y las relaciones disponibles de garantía deberían proceder de los metadatos reales del mercado. No apliques universalmente un parámetro recordado de un instrumento a todos los contratos que lleven un nombre similar.
Conserva los metadatos utilizados para autorizar cada acción. Si cambia una configuración del mercado, el registro antiguo debería seguir siendo interpretable. Una consulta posterior podría explicar el comportamiento actual sin reproducir las condiciones en que se preparó una orden anterior. Esa diferencia importa al investigar un rechazo o una cantidad inesperada.
Lee el modo activo de la cuenta
La documentación actual accesible mediante el sitio oficial de Hyperliquid describe disposiciones de cuentas estándar, unificadas y de margen de cartera. Sus relaciones de saldos y garantía difieren. Un bot debería leer el modo activo en lugar de asumir que los recursos al contado y de perpetuos están siempre aislados o siempre compartidos.
Bajo las disposiciones unificadas y de margen de cartera, la vista documentada de saldos y las retenciones pueden abarcar actividades que un informe solo de contado o por DEX no captaría correctamente. Por tanto, una estrategia puede ver una oportunidad local atractiva mientras la cuenta más amplia ya ha comprometido los recursos necesarios para respaldarla.
Trata el modo de cuenta como parte del contrato operativo. Un cambio de modo puede alterar la interpretación de saldos y límites aunque la misma estrategia siga activa. Concilia la cuenta después de tal cambio antes de autorizar exposición nueva a partir de supuestos que pertenecían a la disposición anterior.
Separa los límites de estrategia del margen de la plataforma
Que una plataforma acepte una orden no establece que encaje con la política de riesgo del usuario. El requisito de margen de la plataforma y la exposición máxima permitida de la estrategia responden a preguntas diferentes. Un límite interno conservador puede rechazar una orden que la cuenta técnicamente tiene garantía suficiente para colocar.
En un ejemplo ficticio simplificado, tres unidades de un perpetuo lineal a 200 crean 600 de exposición nocional. Si el ejemplo asigna 120 de margen, eso supone un apalancamiento entre valor nocional y margen de cinco veces en la entrada. Un movimiento adverso de precio del diez por ciento crea una pérdida de precio de sesenta unidades antes de comisiones y financiación, consumiendo la mitad de ese importe ilustrativo de margen.
Este cálculo no es una fórmula del precio de liquidación. La liquidación real depende del instrumento, el modo de margen, el estado de la cuenta y los requisitos de mantenimiento. El ejemplo muestra por qué una asignación pequeña de garantía no hace pequeña la posición económica. El tamaño de posición y la pérdida permitida necesitan sus propios límites explícitos.
Elige el comportamiento de la orden para ajustarlo a la intención
Una orden limitada especifica una frontera de precio, mientras que el tiempo de vigencia determina qué ocurre con las cantidades que no se ejecutan inmediatamente. La documentación actual de órdenes de Hyperliquid distingue el comportamiento de permanecer en el libro, el de ejecución inmediata o cancelación y el de solo publicación. El adaptador debería conservar la combinación prevista del usuario en lugar de convertir cada solicitud a un valor predeterminado.
Una orden de ejecución inmediata o cancelación puede ejecutarse parcialmente y dejar cancelado el resto. Una instrucción de solo publicación pretende evitar tomar liquidez inmediatamente; no garantiza que una orden en espera vaya a ejecutarse después ni a ser rentable. La distinción importa al estimar tanto la exposición como los costes de ejecución.
La guía de gestión de la API de Hyperliquid explica por qué deben interpretarse los resultados por acción. La estrategia debería responder al resultado aceptado de la orden real. No debería deducir una posición completa del hecho de que una solicitud contenía la cantidad deseada.
Conserva la intención decimal durante la construcción
Las restricciones de precio y tamaño deberían conservar su precisión prevista desde la decisión de estrategia hasta la acción firmada. Un redondeo descuidado puede ampliar la exposición, mover un límite a través del diferencial o producir una solicitud no válida. La dirección correcta del redondeo depende de qué frontera representa el valor.
Por ejemplo, un importe máximo permitido de compra no debería redondearse al alza simplemente para ajustarlo a una preferencia de visualización. Una instrucción de cierre debería comprobarse frente a la posición actual y el incremento admitido de cantidad. La interfaz puede mostrar una cifra más corta mientras el registro duradero conserva el valor exacto autorizado.
La validación debería ocurrir antes de firmar. Si una cantidad no puede representarse dentro de las reglas actuales del mercado, el sistema debería producir un rechazo explícito o un importe reducido justificado por separado. Ajustar silenciosamente valores después de autorizar hace difícil establecer si la acción ejecutada sigue correspondiendo a la política del usuario.
Mantén al firmante separado de la cuenta de negociación
Un agente delegado puede firmar acciones para una cuenta sin ser la cuenta cuyas posiciones y saldos deberían consultarse. La documentación oficial de carteras de API destaca esta distinción. Leer la dirección del agente como si mantuviera la cuenta de negociación puede producir un resultado vacío y una impresión falsa de que no existe exposición.
Almacena la identidad del firmante y la identidad económica de la cuenta en campos diferentes. El registro de orden también debería identificar cualquier subcuenta aplicable u otro ámbito admitido. Esto impide confundir una comprobación satisfactoria de autenticación con la confirmación de que la estrategia opera sobre la cartera prevista.
Coordina los requisitos de nonce del protocolo por autoridad de firma. El modelo de nonce de acciones firmadas de HyperCore no debería sustituirse por una secuencia supuesta de transacciones EVM. Varios procesos que compartan un firmante necesitan un diseño coordinado, mientras una autoridad separada de firma requiere su propia gestión de permisos y ciclo de vida.
Trata un envío sin respuesta como sin resolver
Una respuesta perdida deja una pregunta sobre la acción original. No establece que la acción fallara ni que una orden nueva sea segura. Conserva la intención duradera y los identificadores disponibles de orden antes del envío externo para que la recuperación pueda investigar la misma solicitud económica.
Utiliza pruebas actuales de cuenta y órdenes para determinar si la acción creó una orden en espera, se ejecutó, se rechazó o sigue desconocida. Un identificador de orden del cliente puede ayudar a correlacionar registros, pero no debería describirse como una garantía universal de que cualquier carga repetida carece de efecto adicional. Sigue el comportamiento documentado del punto de acceso real.
Mientras el resultado esté sin resolver, conserva la asignación apropiada de recursos y exposición. Liberarla inmediatamente puede permitir que otro proceso autorice una segunda posición. El objetivo de recuperación es establecer qué podría mantener ya la cuenta, no simplemente obtener una respuesta satisfactoria de una solicitud nueva.
Construye la exposición a partir de ejecuciones y órdenes restantes
Una cantidad solicitada, una cantidad ejecutada y un resto abierto son valores separados. Si una orden hipotética solicita cinco unidades y ejecuta dos seguidas de media unidad, el cambio de posición es de 2.5 y la cantidad solicitada restante es de 2.5 hasta que se establezca su estado final de orden.
La revisión de riesgo de la cuenta debería incluir tanto la exposición actual de 2.5 unidades como el posible efecto de ese resto. Una solicitud de cancelación puede intentar eliminar este último, pero el registro no debería borrarlo antes de que el estado aceptado de la orden confirme qué ocurrió.
Elimina las pruebas duplicadas de ejecuciones cuando los flujos se repitan o las consultas históricas se solapen. Contar dos veces la misma ejecución de media unidad sobrevaloraría la posición y puede llevar a una acción de cierre demasiado grande. Conserva la identidad estable de ejecución y concilia los totales con la vista oficial de la cuenta en lugar de asumir que cada mensaje recibido describe una operación nueva.
Recomienda y gana USDC
Recomienda y gana USDCNuestro programa de afiliados paga en tiempo real.
Diseña salidas reduce-only del bot de perpetuos de Hyperliquid
Las salidas reduce-only de un bot de trading de perpetuos de Hyperliquid deberían expresar la intención de reducir una posición existente sin abrir exposición en la dirección opuesta. Las opciones actuales de órdenes incluyen este control. Resulta útil cuando otra acción podría haber cambiado la posición antes de que la salida alcance la ejecución.
Supongamos que una cuenta ficticia tenía una posición larga de tres unidades cuando se preparó una salida, pero otra venta autorizada la ha reducido a una. Una venta sin restricciones de tres podría cerrar la posición larga restante y crear una corta de dos unidades. Una restricción reduce-only correctamente aplicada aborda esa inversión no deseada, sujeta a las reglas reales de aceptación y ejecución de la plataforma.
Reduce-only no garantiza que una salida se complete ni obtenga un precio concreto. La orden todavía puede encontrar liquidez insuficiente de contrapartida, parámetros no válidos u otras condiciones de rechazo. El bot debe conciliar la posición restante después del intento en lugar de tratar la presencia de la opción como prueba de que el riesgo ha desaparecido.
Distingue un desencadenante de salida de una ejecución de salida
Una condición de stop o take-profit puede activar una orden sin completar una disposición. La referencia de activación, la condición de precio, el tipo resultante de orden y el tamaño deberían ser explícitos. Las decisiones diferentes crean equilibrios distintos entre el control del precio y la probabilidad de ejecución bajo condiciones cambiantes.
Una orden limitada activada puede permanecer sin ejecutar si el mercado supera su intervalo aceptable. Una salida orientada al mercado puede afrontar una ejecución peor que el nivel observado de activación. Ninguna debería presentarse como una pérdida máxima garantizada ni como un beneficio realizado garantizado.
Sigue la posición durante la activación y las ejecuciones posteriores. Si solo se cierra una parte, la cantidad restante sigue necesitando gestión. El controlador de salida también debería tener en cuenta la actividad manual o una acción de otra estrategia para que los tamaños antiguos de activación no se vuelvan silenciosamente incoherentes con la cuenta actual.
Gestiona la cancelación como una carrera con el mercado
Una orden puede ejecutarse mientras una solicitud de cancelación está en tránsito. Por tanto, el registro final correcto podría contener una ejecución parcial y un resto cancelado. Esos resultados son compatibles; la cancelación no elimina retroactivamente la operación que ya ocurrió.
Al sustituir una orden, determina qué queda de la instrucción antigua antes de decidir el tamaño de la sustitución. Una cantidad local deseada y el resto actual de la plataforma pueden divergir durante este intervalo. Tratar la sustitución como una orden de tamaño completo sin relación puede crear exceso de exposición.
La guía de recuperación operativa de Hyperliquid explica por qué las obligaciones necesitan una responsabilidad clara. Un componente debería decidir cómo encajan la orden antigua, las ejecuciones intermedias y la revisión propuesta. Varios procesos que reparan de forma independiente la misma cancelación pueden producir más incertidumbre que el retraso original.
Mantén separada la contabilidad de financiación del bot de perpetuos
La financiación es un componente de flujo de efectivo de la exposición perpetua, distinto de la ganancia o pérdida causada por los precios de entrada y salida. La documentación actual de financiación describe pagos entre tenedores de posiciones largas y cortas y utiliza el valor nocional basado en el oráculo en su cálculo de pagos. No sustituyas un precio de marca visible sin comprobar la convención real.
Para un intervalo ficticio, dos unidades a un precio de oráculo de 500 representan 1,000 de valor nocional de financiación. Una tasa supuesta de pago del 0.01% produce un pago de 0.1. Seis intervalos idénticos sumarían 0.6, pero las tasas, los precios y los tamaños de posición reales pueden cambiar entre observaciones.
La tasa del ejemplo es inventada y no predice una dirección de pago. Registra los abonos y cargos reales a partir de pruebas de la cuenta, vinculados al período y la posición pertinentes. Una previsión de financiación puede informar una decisión, pero no es lo mismo que financiación ya ganada o pagada.
Concilia los resultados de precio, las comisiones y la financiación
Mantén separados los componentes antes de calcular el resultado neto. En una posición larga hipotética simplificada, dos unidades abiertas a 500 y cerradas a 520 producen cuarenta de ganancia bruta de precio. Si los costes registrados de negociación suman tres y la financiación neta es un cargo de 1.2, el resultado es de 35.8 antes de cualquier otro coste aplicable.
Por tanto, un movimiento rentable de precio puede coexistir con una ganancia menor de la cuenta, y un resultado plano de precio todavía puede perder dinero después de los costes. El registro debería hacer visibles esas diferencias en lugar de forzar todos los cambios de saldo a una cifra única de operación realizada.
Utiliza los activos reales de garantía y comisiones comunicados para el mercado y la cuenta pertinentes. Si se necesita una conversión a moneda de información, conserva su hora de valoración y las cantidades originales. Los cambios en el valor del activo de información no deberían confundirse con una ejecución mejorada de la propia estrategia de perpetuos.
Mantén un registro de cierres parciales
Una salida parcial debería asignar de manera coherente las condiciones económicas de la posición mientras conserva la exposición restante. Considera una posición larga inventada de dos unidades abierta a 500. Cerrar 0.75 a 510 crea 7.5 de ganancia de precio. Las 1.25 restantes, cerradas después a 498, pierden 2.5, lo que deja cinco de ganancia bruta de precio en toda la posición.
Si las comisiones combinadas son de 1.8 y la financiación es un cargo de 0.4, el resultado neto completo es de 2.8. Informar únicamente de la primera disposición rentable sobrevaloraría sustancialmente el resultado. Informar de la posición completa de dos unidades como cerrada después de esa primera ejecución también borraría el riesgo restante.
Los métodos de cuenta pueden diferir en cómo presentan la entrada media y los componentes realizados, por lo que la reconstrucción local debería seguir la convención documentada y conciliarse con la cuenta. Conserva las ejecuciones y flujos de efectivo subyacentes aunque el informe de cara al usuario presente un resumen más sencillo.
Vigila el margen sin inventar un colchón fijo de liquidación
El riesgo de liquidación depende de la exposición actual, las relaciones de garantía y las reglas de mantenimiento. Una distancia porcentual respecto a un precio antiguo de entrada no es una medida completa. Otras posiciones, la financiación y los cambios de valor de la cuenta pueden afectar a los recursos disponibles bajo la disposición activa de margen.
Utiliza las pruebas pertinentes actuales de la cuenta y los parámetros del instrumento. Una estimación calculada debería indicar sus supuestos y no debería mostrarse como garantía de que no puede producirse una liquidación antes de un precio determinado. Los cambios rápidos y las referencias diferentes de precio pueden hacer engañosa una frontera simplista.
La estrategia debería definir qué hace cuando las pruebas requeridas de margen no están disponibles. Seguir añadiendo exposición porque el último colchón registrado parecía cómodo puede agravar la incertidumbre. Pausar el riesgo nuevo mientras se mantiene la observación y la gestión autorizada de posiciones es una acción diferente de asumir que una posición abierta se ha vuelto segura simplemente porque el bot está pausado.
Reconstruye la cuenta antes de reanudar tras un reinicio
El arranque debería recuperar las intenciones duraderas, los identificadores aceptados de órdenes, los restos abiertos, las ejecuciones, los sucesos de financiación y las transferencias pertinentes. Después debería comparar esa reconstrucción con el estado actual de la cuenta. Una conexión saludable por sí sola no establece que la estrategia conozca sus obligaciones existentes.
Debe incluirse la actividad manual. Si el usuario redujo una posición mientras el proceso estaba desconectado, el bot no debería restaurar automáticamente el tamaño antiguo para ajustarse a su memoria local obsoleta. El cambio externo de cuenta es una prueba de que cambió el estado operativo y podría requerir una decisión nueva de política.
Reanuda las entradas nuevas solo cuando los registros requeridos las respalden. Las diferencias sin explicar deberían seguir visibles con un ámbito definido de investigación. Sobrescribir discretamente el registro local con un total actual puede ocultar ejecuciones duplicadas, costes ausentes o una orden cancelada que se ejecutó parcialmente antes de desaparecer de la lista de órdenes abiertas.
Ensaya una salida interrumpida
Un ejercicio ficticio útil comienza con una posición larga de tres unidades y una solicitud reduce-only para cerrar dos. La conexión se pierde después del envío. Durante la interrupción, se ejecutan 1.5 unidades y la orden restante de media unidad se cancela después. La posición resultante correcta es una larga de 1.5 unidades, suponiendo que no haya otra actividad.
El proceso de recuperación debería encontrar tanto la ejecución como el resto cancelado. No debería asumir que se cerraron las dos unidades previstas ni volver a enviar una salida nueva de dos unidades únicamente porque faltó la respuesta original. Cualquier reducción adicional debería basarse en la posición actual de 1.5 unidades y la política activa.
Amplía el ejercicio repitiendo el mismo mensaje de ejecución. La exposición debería permanecer sin cambios después de eliminar el duplicado. Este escenario prueba varias fronteras importantes a la vez: identidad duradera, ejecución parcial, cancelación, reinicio y protección frente a la inversión no deseada. La prueba tiene éxito cuando se explica la cuenta final, no cuando cada solicitud responde rápidamente.
Evalúa la automatización mediante la posición que deja
Un bot de perpetuos debería juzgarse por si sus registros de posiciones y recursos siguen siendo correctos durante el funcionamiento ordinario e interrumpido. Las solicitudes rápidas solo son útiles cuando la aplicación puede identificar la cuenta, interpretar cada resultado y explicar la exposición que permanece.
Revisa conjuntamente los intentos completados y sin resolver. Registra con qué frecuencia necesitó recuperación la estrategia, qué supuestos cambiaron y si se mantuvieron los límites internos durante la simultaneidad. Mantén los resultados de negociación separados de la corrección operativa para que un movimiento favorable del mercado no oculte un ciclo defectuoso de órdenes.
Un bot comprensible de trading de perpetuos de Hyperliquid conecta una intención limitada con ejecuciones reales, reconoce la financiación como su propio flujo de efectivo y gestiona las salidas frente a las posiciones actuales. Esas disciplinas no pueden eliminar el riesgo de derivados, pero proporcionan al usuario una base coherente para decidir qué tiene permitido hacer la cuenta a continuación.