Sí, por la API pública
Sí: Hyperliquid publica toda su interfaz de trading como una API HTTP pública, la misma que usa la interfaz web. Las lecturas no piden clave, las escrituras piden una acción firmada, y una cuenta puede aprobar un wallet de API para que las firme en vez de su propia clave.
| Para qué sirve | Dónde |
|---|---|
| Lecturas: precios medios, libro L2, velas, historial del funding, estado de una cuenta. Sin clave, sin firma. | POST https://api.hyperliquid.xyz/info |
Escrituras: order, cancel, modify, updateLeverage, approveAgent, withdraw3 y las demás, cada una firmada. | POST https://api.hyperliquid.xyz/exchange |
Flujos en directo (allMids, l2Book, trades, candle, userFills), y una alternativa a enviar por HTTP. | wss://api.hyperliquid.xyz/ws |
| Los mismos tres caminos en la plataforma de prueba. | api.hyperliquid-testnet.xyz |
Importan tres direcciones, abajo, y cada cifra de esta página es la de la documentación a 5 de octubre de 2026.
Los SDK que lista la documentación
No tienes que montar acciones firmadas a mano. La documentación nombra un SDK de Python oficial, hyperliquid-dex/hyperliquid-python-sdk, un SDK de Rust de la comunidad, dos SDK de TypeScript de la comunidad (nktkas/hyperliquid y nomeida/hyperliquid) y CCXT.
La firma es la parte que conviene tomar prestada antes que reescribir. Una acción se serializa y se firma en una forma exacta, y una forma equivocada en un solo campo se rechaza: la orden nunca llega al libro.
Wallets de API y nonces
Una cuenta maestra puede aprobar wallets de API para que firmen en nombre de la cuenta maestra o de cualquiera de sus subcuentas. Solo firman: para consultar los datos de una cuenta tienes que pasar la dirección real de esa cuenta, y usar el wallet de agente da un resultado vacío.
Los nonces son más estrictos de lo que parecen. Hyperliquid guarda los 100 nonces más altos por dirección, y una acción nueva necesita un nonce mayor que el más pequeño de ese conjunto, nunca usado antes, y dentro de una ventana de (T menos 2 días, T más 1 día), donde T es la marca de tiempo del bloque en milisegundos unix.
Un wallet de API se poda cuando se registra un wallet nuevo sin nombre, cuando un wallet nuevo con nombre toma un nombre existente, cuando caduca, o cuando la cuenta que lo registró se queda sin fondos. La documentación advierte de que a un agente dado de baja se le puede podar el estado de los nonces, así que se pueden repetir acciones firmadas antes: genera un wallet de agente nuevo en vez de revivir uno viejo.
Los límites de peticiones, tal como están documentados
- Por IP. Las peticiones REST comparten un límite de peso agregado de 1.200 por minuto. Una acción de intercambio pesa
1 + floor(batch_length / 40), así que un lote es casi gratis; la mayoría de las peticiones de información pesan 20, un puñado pesa 2, yuserRolepesa 60. - Por dirección. 1 petición por cada 1 USDC operado de forma acumulada, después de un colchón inicial de 10.000 peticiones, y luego una petición cada 10 segundos. Las cancelaciones tienen una asignación más amplia.
- Websocket. Como máximo 10 conexiones, 30 conexiones nuevas por minuto, 1.000 suscripciones, 2.000 mensajes enviados por minuto y 100 mensajes post simultáneos en vuelo.
- Órdenes abiertas. Un límite por defecto de 1.000, más una por cada 5 M de USDC de volumen, con un tope total de 5.000.
El límite por dirección sorprende a un programa nuevo: su asignación se gana operando, y un bucle que reintenta a ciegas la gasta en nada.
Un script, un bot, un asistente
| Qué es | Quién decide | Qué te pide |
|---|---|---|
| Un script | Tú, cuando lo escribiste. Recorre una secuencia y no elige nada. | Leerlo antes de lanzarlo. Sus límites son las líneas que teclaste. |
| Un bot | Una regla que escribiste, cada vez que se cumplen sus condiciones, sin vigilancia. | Límites fuera de la regla, y una forma de pararlo con un solo comando. |
| Un asistente (un agente de IA) | Un modelo propone; el código comprueba la propuesta contra cifras. | Límites que no puede ampliar, y una clave que no puede retirar. |
La API no puede saber cuál de los tres la llama, y aplica las mismas reglas a los tres. Se diferencian en dónde se toma la decisión y en qué pasa cuando es equivocada: un script que se equivoca se equivoca una vez, un bot toda la noche.
Locker Protocol Agentic es del tercer tipo: lpa para una persona o un agente de IA, un servidor MCP con los mismos comandos como herramientas, una política local comprobada dos veces antes de cualquier orden, y un mandato firmado por tu propia wallet. No promete ningún resultado.