LUNIJI
DESKTOP CONNECTION GUIDEHYPERLIQUID

Hyperliquid Setup.

Your account. Your keys. Your command center.
Connect your desktop trading app, one clear step at a time.

Start the setupOpen Hyperliquid API
6 guided stepsTap any image to enlargeAPI agent connection
BEFORE YOU BEGIN

Two addresses. Different jobs.

Have your Hyperliquid account connected and the desktop app ready. This guide covers the Hyperliquid connection specifically.

Main wallet addressPUBLIC ADDRESS
Your actual trading account. Use this in the app’s Main wallet address field.
API wallet addressAGENT IDENTITY
Generated on Hyperliquid. It identifies the agent; do not substitute it for your main account.
API agent private keyKEEP SECRET
The agent’s signing key. Use this in the app’s API agent private key field.

API agents can submit trading actions but do not have withdrawal permissions. Protect the key: trading access can still put funds at risk.

01
ON HYPERLIQUID

Start at the source.

Open Hyperliquid and connect the wallet for the account you want to trade. In the top navigation, open More, then select API.

Hyperliquid · More → API
  • Use the same Hyperliquid account you intend to connect to the desktop app.
  • The API page is where you create and manage an API wallet, also called an agent wallet.
02
ON HYPERLIQUID

Give your connection a name.

Enter a recognizable name for this connection, such as “Desktop trading app”. Then choose Generate to create a new API wallet.

Name the API wallet, then choose Generate
  • The name is just a label to help you recognize this connection later.
  • Generate creates a separate API wallet. You do not need your main wallet’s private key.
03
ON HYPERLIQUID

Review your new API wallet.

A new API wallet address now appears beside the name. Choose Authorize API Wallet to open the approval window.

Generated agent address → Authorize API Wallet
  • This generated address identifies the API agent. It is different from your main wallet address.
  • Keep that distinction in mind: the desktop app’s Main wallet address field needs your actual trading account address.
04
ON HYPERLIQUID

Save the key. Then authorize.

Choose how long the authorization should remain valid. MAX selects the longest period offered in the window; choose a duration you are comfortable with.

Example only · private key hidden
  • Copy the generated API agent private key before leaving this window. Store it securely in a password manager.
  • Choose Authorize, then review and sign the API-wallet approval in your connected wallet.
  • The private key will not be shown again after authorization. Never share it, post it in screenshots, or paste it into this website.

The key in this guide is hidden on purpose. Generate and save your own API agent key. Never copy credentials from an example.

05
ON HYPERLIQUID

Make sure your agent is listed.

After approval, the API wallet should appear in the list with its name, address and expiration date. That confirms the agent has been authorized.

Look for the API wallet name and Valid Until date
  • The list shows the API wallet address, not its private key.
  • If you missed saving the key, remove that API wallet and repeat the process with a newly generated one. Do not reuse the old agent.
06
IN YOUR DESKTOP APP

Two fields. One connection.

Open the desktop app’s settings and select Connection. Pair your main account’s public address with the API agent private key you just saved.

Desktop app · Connection settings
  • Main wallet address → your actual Hyperliquid trading account’s public address, not the generated API wallet address.
  • API agent private key → the private key copied from the authorization window in step 4. Never enter your main wallet private key or seed phrase.
  • Save Settings, then use Reconnect / Test to verify the connection. Check that the account shown is the one you intended to connect.
CONNECTION CHECKPOINT

Connected. Keep control.

Confirm the account and connection status before using order controls. Connecting an agent is separate from placing a trade.

IF SOMETHING DOESN’T LINE UP

A quick systems check.

The connection works, but my balances look empty.

Check Main wallet address first. It should be the public address of your actual trading account, not the generated API wallet. Also confirm you authorized the agent from that same account.

I lost the key, or the agent expired.

Remove the affected API wallet on Hyperliquid, generate a new agent and authorize it. Save the new key, update the app’s API agent private key field, save settings and reconnect.

I want to disconnect this app.

On Hyperliquid’s API page, identify this app’s API wallet by its name and address, then select Remove. That revokes the agent’s authorization. A replacement connection should use a newly generated agent.