API wallets (agent wallets) de Hyperliquid (2026): permisos, configuración, riesgos y seguimiento en solo lectura

En resumen: una API wallet de Hyperliquid (o agent wallet) es una clave aparte que tu wallet principal autoriza para colocar y cancelar órdenes en su nombre. Puede operar, pero no puede retirar fondos. La usan bots, terminales y bots de Telegram. Un tracker de portfolio no la necesita: tus datos de Hyperliquid son públicos, así que una herramienta de solo lectura como Hyperfolio solo necesita tu dirección.

¿Qué es una API wallet en Hyperliquid?

Cada acción en Hyperliquid (órdenes, cancelaciones, cambios de apalancamiento) es un mensaje firmado con una clave privada. Firmar cada una con tu wallet de hardware es lento, y darle tu clave principal a un bot es peligroso. La agent wallet lo resuelve: generas un par de claves nuevo y tu wallet principal firma una vez la acción approveAgent, que dice «esta dirección puede operar por mí». Desde entonces el bot firma con la clave del agente y las órdenes van a tu cuenta.

Qué puede y qué no puede hacer

Acción	Agent wallet	Wallet principal
Colocar, modificar, cancelar órdenes	Sí	Sí
Cambiar apalancamiento / modo de margen	Sí	Sí
Operar subcuentas y vaults que lideras	Sí (vaultAddress)	Sí
Retirar a una dirección externa	No	Sí
Enviar USDC o tokens a otro usuario	No	Sí
Aprobar nuevos agentes	No	Sí

Una clave de agente filtrada no puede vaciar tu cuenta directamente, pero sí puede hacerte perder dinero abriendo posiciones enormes o operando en libros sin liquidez. Trátala como un secreto.

Cómo crear una API wallet

1. Conecta tu wallet principal en app.hyperliquid.xyz y abre la página API desde el menú.
2. Genera una API wallet nueva (o pega una dirección creada por ti), ponle nombre y, si quieres, un periodo de validez.
3. Autorízala con una firma de tu wallet principal. Copia la clave privada que se muestra una sola vez y guárdala en el gestor de secretos del bot, nunca en el código ni en un chat.
4. En el bot, firma con la clave del agente pero usa la dirección de tu cuenta principal para consultar y operar. Consultar la dirección del agente es el fallo más común: no tiene saldo propio.

Hyperliquid limita cuántos agentes con nombre puede tener una cuenta, y aprobar uno nuevo con un nombre existente sustituye al anterior. Revisa los límites actuales en la documentación oficial. Ejemplos de código en la guía de la API con Python y la guía de bots.

Nonces: un agente por bot

Hyperliquid controla los nonces por firmante y cada acción necesita un nonce reciente y único (normalmente un timestamp en milisegundos). Si dos procesos comparten clave, los nonces chocan y las órdenes se rechazan al azar. Da a cada bot su propia agent wallet y no reutilices direcciones de agentes dados de baja: genera una clave nueva.

Checklist de seguridad

• Crea la clave del agente tú mismo o en la app oficial; nunca pegues tu semilla principal en un bot, terminal o web de «trading con IA».
• Las herramientas que te piden aprobar un agente pueden operar tu cuenta. Aprueba solo las de confianza y revoca las que ya no uses.
• Pon caducidad cuando puedas y rota las claves tras incidentes.
• Ejecuta los bots en una subcuenta dedicada.
• Lee la guía de seguridad de wallets.

Cómo ver qué agentes tienes aprobados

curl -s https://api.hyperliquid.xyz/info \
  -H 'Content-Type: application/json' \
  -d '{"type":"extraAgents","user":"0xTU_DIRECCION_PRINCIPAL"}'

Si ves un nombre o dirección que no reconoces, elimínalo en la página API y revisa tus últimas ejecuciones.

¿Necesitas una API wallet para seguir tu portfolio?

No. Saldos, posiciones, fills, funding y PnL en Hyperliquid son datos públicos por dirección. Un tracker que te pide API key, aprobar un agente o una firma para «ver tu PnL» pide más poder del necesario. Hyperfolio es gratis y de solo lectura: pega tu dirección (y subcuentas o cuentas de bots) y verás equity, perps abiertos, PnL cerrado y no realizado, comisiones y funding, sin claves. Más en seguir Hyperliquid sin API keys.

Ejemplo: vigilar un bot con seguridad

Tienes un grid bot con agent wallet en la subcuenta «bot-eth» con 5.000 $. El bot firma con la clave del agente y no puede retirar. En el móvil, Hyperfolio vigila «bot-eth» y tu master en solo lectura, y cada día ves si el PnL del bot sobrevive a comisiones y funding (guía de PnL real) sin poner ninguna clave en el teléfono.

Preguntas frecuentes

¿Una API wallet puede retirar mis fondos?

No. Puede operar, pero no retirar ni transferir; eso solo lo hace la wallet principal.

¿Es lo mismo que una subcuenta?

No. La subcuenta es una cuenta con saldo propio; la agent wallet es una clave de firma sin fondos que opera para una cuenta.

¿Por qué mi bot muestra saldo cero?

Seguramente consultas la dirección del agente. Consulta la principal o la de la subcuenta.

¿Cómo revoco un agente?

Elimínalo en la página API de Hyperliquid o deja que caduque si le pusiste validez.

¿Hyperfolio necesita una API wallet?

No. Solo lee datos públicos por dirección y nunca pide claves, agentes ni firmas.

Tus claves, para operar, no para mirar: sigue todas tus cuentas de Hyperliquid en Hyperfolio, gratis y en solo lectura. ¿Nuevo en Hyperliquid? El código HYPERFOLIO te da un 4% de descuento en comisiones.