Hyperliquid

This guide shows how to connect Hyperliquid to IQai Bot so you can trade directly from alerts and manage positions from Telegram.

Before you start (important)

Hyperliquid uses two identities:

• Main Address (your account address) Used for reads (positions, balances, etc.)

• API Wallet / Agent (a separate wallet you approve as an API wallet) Used to sign trading actions. IQai Bot stores the agent private key encrypted and never displays it back to you.

✅ Recommended:

• Use a dedicated agent wallet for IQai Bot

• Never share seed phrases (the bot never asks)

---

Step 1 — Create/approve an API Wallet on Hyperliquid

1. Open Hyperliquid (https://app.hyperliquid.xyz/)

   1. For testnet: https://app.hyperliquid-testnet.xyz/

2. Go to More > API

3. Enter the name for the API Wallet

4. Click Generate

5. Click Authorize API Wallet

You’ll need:

• Your Main Address (0x…)

• Your API Wallet Private Key (as shown in the screenshot below)

---

Step 2 — Open the Hyperliquid exchange card in IQai Bot

1. Open IQai Bot in Telegram.

2. Run: /exchanges

3. Tap Hyperliquid

---

Step 3 — Choose the environment (Testnet / Mainnet)

On the Hyperliquid card, tap Toggle Env to switch environment:

• Testnet: best for testing

• Mainnet: real trading

Make sure the card shows the environment you intend to use.

---

Step 4 — Enter your Main Address + Agent Private Key

Inside the Hyperliquid card:

1. Tap Main Address → paste your Hyperliquid account address (0x…)

2. Tap API Privkey → paste the agent wallet private key (64 hex characters you've got when Authorizing API Wallet)

IQai Bot stores the agent key encrypted and never shows it back to you.

---

Step 5 — Verify the connection

After credentials are set, tap:

✅ Verify

If verification succeeds, IQai Bot will confirm and will show the inferred Agent Wallet Address (confirm it matches your API Wallet Address)

If verification fails:

• Confirm the agent wallet is approved on Hyperliquid’s API page

• Confirm you pasted the correct private key (no extra spaces)

• Confirm you’re on the intended environment (testnet vs mainnet)

---

Step 6 — Set your margin mode (Cross vs Isolated)

Hyperliquid supports:

• Cross: margin shared across positions

• Isolated: margin per-position (per asset)

In the Hyperliquid card, tap Margin Mode and choose Cross or Isolated.

---

Step 7 — Use Hyperliquid for execution

To route trades to Hyperliquid:

1. Run: /exec

2. Select:

   • hyperliquid_testnet or

   • hyperliquid_mainnet

---

Recommended first test

1. Set Hyperliquid to Testnet with Toggle Env

2. Enter Main Address + API Privkey

3. Tap Verify

4. Choose Margin Mode (Cross or Isolated)

5. Set your presets: /preset

6. Set execution: /exec → Hyperliquid testnet

7. Test: /open btc with a small preset