Documentación
¿Qué quieres hacer?
Conectar Hyperliquid
Hyperliquid usa una API wallet: una clave delegada autorizada por tu cuenta principal que puede enviar órdenes pero no retirar. MyLiquidBot necesita la dirección de tu cuenta principal (donde están los fondos) y la clave privada de la API wallet. Nunca se necesitan la clave privada ni la frase semilla de tu wallet principal.
Las cuentas de Hyperliquid creadas con email o login social no son compatibles. Usa una cuenta creada con tu propia wallet (MetaMask, Rabby, Coinbase Wallet, etc.).
En Agregar conexión elige Hyperliquid y deja seleccionado Quick Connect. Pulsa Conectar wallet del navegador o WalletConnect y firma con la wallet principal de tu cuenta de Hyperliquid: MyLiquidBot crea la API wallet, Hyperliquid la asocia a tu cuenta y el asistente pasa a Activar trading. No mueve fondos, no cuesta gas y la clave nunca puede retirar. Dura unos 180 días; renuévala antes desde Gestionar → API wallet con otra firma. Si prefieres crearla tú, elige Pegar API key y sigue las partes 1 y 2.
Parte 1 — Crear la API wallet en Hyperliquid
Abre Hyperliquid con tu wallet principal
Entra en app.hyperliquid.xyz, conecta la wallet dueña de la cuenta y de los fondos, y comprueba que hay USDC depositado.
Abre la página API y genera una API wallet
Abre API en el menú de Hyperliquid, pon un nombre a la API wallet, genérala y autorízala con tu wallet principal. Hyperliquid muestra la clave privada de la API wallet una sola vez: guárdala en un gestor de contraseñas.
Ten en cuenta la validez
Si Hyperliquid pide un periodo de validez, elige el que te convenga y recuérdalo. Cuando la API wallet caduca, la conexión deja de operar y tienes que crear una nueva y editar la conexión.
Parte 2 — Agregar la conexión en MyLiquidBot
Ve a Cuenta → Exchanges → Agregar conexión, elige Hyperliquid, confirma que la cuenta se creó con tu propia wallet y rellena:
| Campo en MyLiquidBot | Qué poner |
|---|---|
| Nombre de la conexión | Cualquier etiqueta de al menos 3 caracteres, p. ej. Hyperliquid Principal. |
| Dirección de wallet | La dirección de tu cuenta principal (0x…), la wallet que tiene los fondos en Hyperliquid. No la dirección de la API wallet. |
| Hyperliquid API Wallet - Private Key | La clave privada mostrada una vez al crear la API wallet (64 caracteres hexadecimales, con o sin 0x). |
| Dirección de vault (opcional) | Solo si operas un vault de Hyperliquid que gestionas. La mayoría la deja vacía. |
| URL de API (opcional) | Déjala vacía. |
Pulsa Guardar y verificar. MyLiquidBot comprueba que la clave es una API wallet válida autorizada para esa cuenta.
Parte 3 — Activar trading (Builder Fee)
Conecta la wallet principal
En el paso de activación (o luego en Gestionar, apartado de activación de trading) pulsa Conectar wallet y elige la wallet del navegador o WalletConnect. Usa la misma wallet principal guardada en la conexión.
Pulsa Activar trading y firma
La wallet pide una firma. No es una transacción, no cuesta gas, no mueve fondos y nunca permite retiros. Hyperliquid solo la acepta si la cuenta ya tiene un depósito.
Comprueba el estado
Cuando el panel indica que el trading está activo, bots y órdenes manuales pueden usar la conexión. Si muestra Actualización requerida, activa de nuevo. Si hay una sincronización pendiente, abre Avanzado → Reintentar sincronización.
En Hyperliquid no hace falta fijar el leverage antes. Los creadores de bots y el ticket de Trade sincronizan el leverage y el modo Cross/Isolated que elijas para cada mercado.
Solución de problemas
| Mensaje o síntoma | Causa probable | Solución |
|---|---|---|
| “La Hyperliquid API Wallet - Private Key no coincide con la wallet y no aparece como API wallet aprobada para esa cuenta.” | La dirección de wallet no es la cuenta que autorizó la API wallet, o la API wallet caducó o se eliminó. | Pon la dirección de la cuenta principal. Comprueba en la página API de Hyperliquid que la API wallet sigue listada; si no, crea otra y edita la conexión. |
| “Formato inválido de Hyperliquid API Wallet - Private Key…” | Clave incompleta, espacios de más o se pegó una dirección en vez de la clave. | Vuelve a pegar la clave privada completa de 64 caracteres. |
| “Invalid wallet address. It must use 0x format.” | Dirección incorrecta o cortada. | Copia la dirección 0x… completa de la wallet principal. |
| El balance sale 0 | Se puso la dirección de la API wallet en la dirección de wallet, o la cuenta no tiene depósito. | Edita la conexión con la dirección de la cuenta principal; deposita USDC en Hyperliquid. |
| “Hyperliquid exige un depósito en esta cuenta antes de aceptar la aprobación.” | La cuenta nunca ha recibido un depósito. | Deposita USDC en esa wallet en Hyperliquid y activa de nuevo. |
| “Abre la misma wallet guardada en la conexión” | Hay otra cuenta seleccionada en la wallet. | Cambia la wallet a la cuenta principal guardada y firma de nuevo. |
| Operaba y dejó de hacerlo | La API wallet caducó o fue revocada. | Crea una API wallet nueva, edita la conexión con la nueva clave y guarda. |