Clave API de HyperLiquid

HyperLiquid usa un modelo de wallet agente en lugar de una clave API tradicional. Un wallet agente es una dirección de wallet separada que autorizas para operar en nombre de tu cuenta principal. Aegis actúa como agente usando la clave privada del wallet agente.

Antes de comenzar, revisa el modelo de permisos en Descripción general de API Keys.

Abre HyperLiquid y ve a la configuración de API / Agente. Inicia sesión en app.hyperliquid.xyz, ve a Configuración, luego a API o Wallets Agente.
Genera un nuevo wallet agente y copia su clave privada. Haz clic en Crear Agente o Generar Wallet API. HyperLiquid genera una nueva dirección de wallet y su clave privada (64 caracteres hexadecimales). Copia y guarda la clave privada de forma segura — se muestra solo una vez. Esta clave privada es el valor que ingresarás en el dashboard de Aegis como el API Key Secret; no ingresas la dirección del wallet agente manualmente (Aegis la deriva del lado del servidor). Anota también tu dirección de cuenta principal de HyperLiquid — esa es la que ingresarás como dirección del wallet.
Autoriza al wallet agente para operar. Confirma la transacción de autorización en tu wallet principal de HyperLiquid. El wallet agente ahora tiene permisos de trading en tu cuenta. No puede retirar fondos.

Qué ingresar en el dashboard de Aegis

Al agregar un wallet de ejecución de HyperLiquid en Aegis, el formulario de Agregar Wallet pide solo dos entradas de credenciales — no hay un campo “Clave API” manual para HyperLiquid:

Exchange: HyperLiquid
Tipo de bot: Bastion, Vanguard u Orbit (obligatorio, fijo al crearlo)
Nombre / Etiqueta: un identificador descriptivo para este wallet de ejecución
Dirección del wallet (walletAddress): tu dirección de cuenta principal de HyperLiquid — la cuenta desde la que autorizaste el wallet agente. No es la dirección del wallet agente ni la dirección de tu wallet LP.
API Key Secret: la clave privada del wallet agente generada en el paso 2 (64 caracteres hexadecimales). Es el único secreto que HyperLiquid necesita.

Después de guardar, Aegis deriva la dirección del wallet agente del lado del servidor a partir del API Key Secret y te la muestra en la pantalla de confirmación — nunca escribes tú la dirección del wallet agente. El API Key Secret (clave privada del agente) se cifra con AES-256-GCM en reposo y nunca se muestra de vuelta después de guardarlo.

Contraste con Binance: un wallet de ejecución de Binance pide una clave API y un secreto de API (dos cadenas distintas emitidas por el exchange). HyperLiquid pide la dirección de cuenta principal (walletAddress) y el API Key Secret únicamente.

Modelo de permisos

Los wallets agente de HyperLiquid tienen permisos solo de trading por diseño. El wallet agente no puede retirar fondos ni mover fondos entre cuentas.

Permiso	Estado
Lectura / Datos de mercado	Requerido
Futuros / Trading de derivados	Requerido
Retiro de fondos	DEBE estar deshabilitado — el wallet agente no tiene permiso de retiro
Transferencias internas	Debe permanecer deshabilitado — NO habilitar
Retiros bancarios / Fiat	No aplica para HyperLiquid

Siguiente paso

Agrega el wallet de ejecución al dashboard de Aegis.

Última verificación: 2026-05-12