HyperLiquid API Key

HyperLiquid uses an agent wallet model instead of a traditional API key. An agent wallet is a separate wallet address that you authorize to trade on behalf of your main account. Aegis acts as the agent using the private key of the agent wallet.

Before starting, review the permission model in API Keys Overview.

1. Open HyperLiquid and navigate to API / Agent settings. Log in to app.hyperliquid.xyz, go to Settings, then API or Agent Wallets.

   

2. Generate a new agent wallet and copy its private key. Click Create Agent or Generate API Wallet. HyperLiquid generates a new wallet address and its private key (64 hex characters). Copy and store the private key securely — it is shown only once. This private key is the value you enter in the Aegis dashboard as the API Key Secret; you do not enter the agent wallet address manually (Aegis derives it server-side). Also note your main HyperLiquid account address — you will enter that as the wallet address.

   

3. Authorize the agent wallet to trade. Confirm the authorization transaction in your main HyperLiquid wallet. The agent wallet now has trading permissions on your account. It cannot withdraw funds.

   

What to Enter in the Aegis Dashboard

When adding a HyperLiquid execution wallet in Aegis, the Add Wallet form asks for only two credential inputs — there is no manual “API key” field for HyperLiquid:

• Exchange: HyperLiquid
• Bot type: Bastion, Vanguard, or Orbit (mandatory, fixed at creation)
• Name / Label: a friendly identifier for this execution wallet
• Wallet address (walletAddress): your main HyperLiquid account address — the account you authorized the agent wallet from. It is not the agent wallet address and not your LP wallet address.
• API Key Secret: the agent wallet private key generated in step 2 (64 hex characters). This is the only secret HyperLiquid needs.

After you save, Aegis derives the agent wallet address server-side from the API Key Secret and displays it back to you on the confirmation screen — you never type the agent wallet address yourself. The API Key Secret (agent private key) is encrypted with AES-256-GCM at rest and never shown back after saving.

Contrast with Binance: a Binance execution wallet asks for an API key and an API secret (two separate exchange-issued strings). HyperLiquid asks for the main account walletAddress and the API Key Secret only.

Permission Model

HyperLiquid agent wallets have trading-only permissions by design. The agent wallet cannot withdraw funds and cannot move funds between accounts.

Permission	Status
Read / Market data	Required
Futures / Derivatives trading	Required
Withdraw funds	MUST be disabled — the agent wallet has no withdrawal permission
Internal transfers	Must remain disabled — MUST NOT enable
Bank / Fiat withdrawals	N/A for HyperLiquid

Next Step

Add the execution wallet to the Aegis dashboard.

---

Last verified: 2026-05-12