# Add a Hyperliquid trading account

> Add your Hyperliquid master account to Mishmar once, by its address, typed in or taken from your browser wallet, then verify it against Hyperliquid. Nothing in it can trade or move funds; each agent gets its own key afterwards.

When you are done, Mishmar knows your Hyperliquid master account: the address you trade from on Hyperliquid. Mishmar reads the account's margin, positions and fills by that address, which takes no key, so nothing you enter here can place an order or move funds.

Trading comes next, one agent at a time: each agent gets its own API wallet on this account, split between the agent's signer and Mishmar, and your master wallet approves it. [Add an agent on Hyperliquid](https://docs.mishmar.io/hyperliquid/add-an-agent.md) has the steps.

Mishmar's alpha trades on Hyperliquid testnet. The console sets the network from the Mishmar it is connected to: testnet here, mainnet on a live Mishmar. You don't choose it.

It takes about two minutes.

## What you need

- **Your Hyperliquid master address**: the account you trade from on Hyperliquid, not an API wallet. On testnet ([app.hyperliquid-testnet.xyz](https://app.hyperliquid-testnet.xyz)), with USDC in it: the account has to have margin to pass verification.
- **The owner or admin role** on the Mishmar account. Approvers and viewers cannot add trading accounts.
- **A passkey or a linked wallet on your Mishmar login.** Hosted Mishmar asks for a fresh proof of one before a change like this one. Add one under **Profile** in the console's sidebar: **Add passkey on this device** under **Passkeys**, or **Link this browser's wallet** under **Wallets**.
- **Optional: the browser wallet that holds the master address** (Rabby, MetaMask or similar), to fill the address in for you. You need it later anyway, to approve each agent's API wallet.
- **Room on your plan.** The free plan holds one trading account, on any venue.

## 1. Start adding a trading account

In the console, open **Trading accounts** and click **Add trading account**. Click **Hyperliquid**.

![Step 1 of 3, Pick the venue, with the Hyperliquid and Binance tiles](https://docs.mishmar.io/screens/hyperliquid/add-a-trading-account/pick-venue.png)

## 2. Enter the master account

- **Name**: what you call the account everywhere in Mishmar.
- **Master address**: paste the address, or click **Use my wallet** to take the address your browser wallet is on. It is your Hyperliquid account, not an API wallet.
- **Network**: set by Mishmar. **Testnet** on the alpha.
- **Does anything other than your agents trade on this account?** Choose **No, only my agents** if Mishmar's agents are the only thing that trades here: an outside trade then blocks new orders until you say whose it is. Choose **Yes, I or other tools trade here too** if you or another bot also trade on it: outside trades then count toward this account's limits, not any agent's. You can change the answer later on the account's page, under **Who trades here**.

Click **Add account**. The console may ask you to confirm with your passkey or wallet first; the proof lasts ten minutes.

![Step 2 of 3, Connect your master account: the name, the master address filled in from the wallet, the network shown as Testnet, and No, only my agents chosen](https://docs.mishmar.io/screens/hyperliquid/add-a-trading-account/master-account.png)

## 3. Verify it

The dialog says the account was added, and shows the master address with its network. Click **Verify now**. Mishmar asks Hyperliquid about the master account and runs three checks:

- **Master account found on the network**, with the address.
- **Master account has margin**, with the amount available. For an account in Hyperliquid's unified-account or portfolio-margin mode, this is the account's USDC balance, and the mode is named after the amount.
- **Network matches**: `testnet`.

When all three pass, the account's status turns **Active**. Click **Done**: the trading account's page opens.

![Step 3 of 3: the master address on Testnet, the account Active, and the three checks passed](https://docs.mishmar.io/screens/hyperliquid/add-a-trading-account/verified.png)

You can also verify later: open the trading account and click **Verify**. Until every check passes, the account stays **Pending**, and an agent's orders on it are blocked with `Trading account … is not verified`.

## Check it worked

- **Trading accounts** lists the account as **Active**, with **Verified** and the date under **Verification**.
- On its page, **Setup** shows the **Master address** and the **Network**, and **Verification** lists the three checks, all passed.
- **Kind** says **Master account**. Copy the account's **Id** (`ta_…`) from **Overview**: an agent proposes orders to it.

![The trading account's Verification card: verified, with the three checks passed](https://docs.mishmar.io/screens/hyperliquid/add-a-trading-account/verification-card.png)

Next, [add an agent on Hyperliquid](https://docs.mishmar.io/hyperliquid/add-an-agent.md).

## When something goes wrong

- **`0x followed by 40 hex characters`** under **Master address**: the address is cut short or has a typo. Paste the whole address, or click **Use my wallet**.
- **Use my wallet is greyed out**: the console found no browser wallet in this browser. Paste the address instead, or install Rabby or MetaMask and reload the page.
- **`Couldn't tell which network. Reload and try again.`** next to **Network**: the console couldn't ask Mishmar which network it trades, and **Add account** stays greyed out. Reload the page.
- **`This needs a passkey or a wallet. Add one under your profile, then try again.`**: your Mishmar login has neither. Open **Profile**, add a passkey or link a wallet, then click **Add account** again.
- **Master account has margin fails, with `$0 available`**: the account holds no USDC on this network. Deposit some on Hyperliquid testnet, then click **Verify again**.
- **The toast says `… of 3 checks still failing`**: the failing checks are marked in red with what Hyperliquid answered. Fix them at Hyperliquid, then click **Verify again**.
- **You entered the wrong address.** A trading account's address can't be changed. On its page, click the bin icon (**Delete trading account**), then add it again. Mishmar refuses with `Agents still hold venue keys on this trading account; revoke them first` while an agent has a key on it: revoke those keys on each agent's **Keys** tab first.
- **`The account's plan holds 1 trading account; delete one or move to a larger plan`**, or **Add trading account** is greyed out with the reason beside it: the free plan holds one trading account, on Hyperliquid and Binance together. Delete one, or move to a larger plan.