How to Connect Your Hyperliquid Wallet to a Trading Bot

Disclosure: fomoed may earn a small commission if you open an account through the exchange links in this article.

Why Hyperliquid for Bot Trading?

Hyperliquid is a decentralized perpetual futures exchange that's become a go-to for automated traders. The reasons are compelling: no KYC, deep liquidity rivaling centralized exchanges, low fees, and — most importantly for bot traders — a wallet-based authentication model that's fundamentally more secure than API keys.

Unlike Binance or Bybit where you create API keys that could theoretically be used to withdraw funds, Hyperliquid uses agent wallets. These are sub-accounts that can only trade — they can never withdraw or transfer your funds. Even if compromised, the worst case is unauthorized trades, not stolen assets.

Prerequisites

Before connecting, make sure you have:

• A wallet with funds on Hyperliquid (you need to have deposited USDC via Arbitrum bridge)
• MetaMask, Rabby, or another EVM-compatible wallet browser extension
• A fomoed account (sign up free here if you haven't)

How Agent Wallets Work

The agent wallet system is Hyperliquid's alternative to API keys. Here's the concept:

1. Your main wallet holds your funds and has full control (deposits, withdrawals, transfers).
2. An agent wallet is a separate address that you authorize to trade on behalf of your main wallet.
3. The agent can place orders, cancel orders, and set leverage — nothing else.
4. You can revoke agent access at any time from your main wallet.

When you connect to fomoed, the platform generates an agent wallet and asks you to approve it. One signature from your main wallet, and you're set.

Step-by-Step Connection Guide

Step 1: Log into fomoed

Navigate to your dashboard and click "Create Bot" or go to the bot wizard.

Step 2: Select Hyperliquid as Your Exchange

In Step 1 of the wizard, select Hyperliquid from the exchange list. You'll see it marked as a DEX — no API key fields here.

Step 3: Connect Your Wallet

Click "Connect Wallet." Your browser wallet extension will prompt you to connect. Select the wallet address you use on Hyperliquid (the one with your deposited funds).

Step 4: Approve the Agent Wallet

Fomoed generates a unique agent wallet for your account. You'll see a prompt to approve this agent — it requires a signature from your main wallet. This is a gasless operation (no transaction fee).

What you're approving: You're authorizing a specific address to place trades on your behalf. The approval is:

• Restricted to trading only (no withdrawals)
• Specific to one agent address
• Revocable at any time from Hyperliquid's interface

Step 5: Verification

Once approved, fomoed verifies the connection by checking your account balance. You'll see a green confirmation with your available margin displayed. The connection is now active.

Step 6: Continue Bot Setup

Proceed through the remaining wizard steps — strategy, pair, timeframe, take profit, stop loss, etc. Your Hyperliquid connection persists across all bots, so you only need to do this once.

Multiple Wallets

If you use multiple Hyperliquid wallets (different strategies, different capital allocations), fomoed supports per-wallet agent connections. Each wallet gets its own independent agent — they don't interfere with each other.

To connect a second wallet:

1. Switch to the desired wallet in your browser extension
2. Create a new bot and select Hyperliquid
3. The platform detects the different address and generates a new agent
4. Approve with the new wallet's signature

Security Benefits Over API Keys

The agent wallet model is superior to CEX API keys in several ways:

Feature	API Keys (CEX)	Agent Wallet (Hyperliquid)
Can withdraw funds?	Possible if permissions misconfigured	Never — architecturally impossible
Key rotation	Manual — create new, delete old	Revoke + re-approve in one step
Compromised key impact	Potential fund loss if withdrawal enabled	Unauthorized trades only, funds safe
IP restriction	Optional (often skipped)	Not needed — agent can only trade
Expiry	Typically none	Permanent until revoked

For comparison with traditional API key setups, see our guide on crypto bot API key security.

Troubleshooting Common Issues

"Wallet not found" error

Make sure you've deposited funds to Hyperliquid. Your wallet needs to have an active account on the platform (at least one deposit transaction).

Agent approval not going through

Try refreshing the page and reconnecting. Some wallet extensions cache stale states. If using MetaMask, ensure you're on the correct network (Arbitrum One).

Balance showing $0 after connection

Give it a few seconds — the balance fetch happens asynchronously. If it persists, check that you're connecting the same wallet address that holds funds on Hyperliquid.

"Agent already exists" message

If you previously connected this wallet, the existing agent is still valid. The platform will use your existing agent connection — no need to re-approve.

Revoking Access

If you ever want to disconnect:

1. Go to app.hyperliquid.xyz
2. Navigate to your account settings
3. Find the agent wallet address in your authorized agents list
4. Click revoke

The agent immediately loses all trading permissions. Any open orders placed by the agent remain active until filled or manually cancelled — revoking the agent doesn't auto-cancel existing orders.

Getting Started

The entire connection process takes under 60 seconds. No API keys to copy-paste, no permissions to configure, no IP addresses to whitelist. Connect your wallet, sign once, and your bot has secure trading access. For the complete Hyperliquid bot setup flow, including strategy selection and configuration, check our detailed Hyperliquid trading bot setup guide.

Create your free fomoed account and connect your Hyperliquid wallet in under a minute.