Definición
Una cuenta maestra puede aprobar wallets de API para firmar en su propio nombre o en el de cualquiera de sus subcuentas. Solo se usan para firmar: los datos de la cuenta hay que consultarlos con la dirección real de la cuenta, y la documentación llama a consultar la dirección del agente un error frecuente, ya que devuelve un resultado vacío en vez de un error. Una cuenta puede tener un wallet aprobado sin nombre y hasta tres con nombre, más dos agentes con nombre por subcuenta, y un vencimiento fijado con valid_until queda como máximo 180 días en el futuro.
Qué puede y qué no puede hacer una clave así se midió en vez de suponerse. El 28 de septiembre de 2026, en el mainnet, una cuenta de prueba aprobó una clave de agente nueva por una hora y le hizo firmar cada acción que mueve dinero por 1.000 USDC contra un saldo de unos 60, así que nada podía moverse y solo contaba el motivo de cada respuesta. Rechazados en el firmante: withdraw3, usdSend, spotSend, sendAsset, usdClassTransfer, un segundo approveAgent y approveBuilderFee, donde la cuenta misma se encontraba con un error de saldo. Aceptados: colocar y cancelar una orden. Y un movimiento de fondos fue aceptado, vaultTransfer, con el que 5 USDC firmados por la clave de agente llegaron a un vault de Hyperliquid.
Un aviso de operación va con la definición. Los nonces se siguen por firmante, y el estado de nonces de un wallet de API se puede purgar cuando el wallet queda fuera de registro por la aprobación de uno nuevo, cuando vence, o cuando la cuenta que lo registró ya no tiene fondos. La documentación dice que entonces se pueden repetir acciones firmadas antes, y recomienda con fuerza no reutilizar nunca una dirección de agente: hay que generar una nueva.
En nuestro propio montaje la clave de agente vive en el ordenador, sellada en el disco bajo una contraseña y guardada en memoria por el guardián solo mientras está desbloqueada. El guardián firma una lista cerrada de acciones de trading y nada más, la clave vence por sí sola con avisos 30, 14, 7, 3 y 1 días antes, y lpa agent revoke la retira con tu wallet. Ningún archivo de un ordenador detiene a un ladrón que tiene la clave y su contraseña, así que el límite que aguanta es la cuenta: lo que contiene es lo más que se puede perder.
Ejemplo
Un ejemplo, en cifras redondas. Una cuenta con 1.000 USDC aprueba una clave de agente, con un vencimiento a 180 días, el techo que Hyperliquid permite. Esa clave puede abrir y cerrar posiciones contra los 1.000 USDC y fijar el apalancamiento y el modo de margen de un mercado; no puede retirar ni un céntimo, enviarlo a otra dirección ni moverlo entre el saldo de spot y el de perpetuos. Todo lo que alcanza son esos 1.000 USDC, y por eso una cuenta dedicada es el límite que importa.