Skip to content

⚠︎ Risk warning: leveraged derivatives on unregulated platforms — you can lose everything you deposit. Not investment advice.

Guide · By · Updated 2026-09-15

Hyperliquid Sub-Accounts and API Wallets (2026)

Rules verified against Hyperliquid's official docs on 2026-09-15.

Sub-accounts let one wallet run several separately margined books — a hedged strategy in one, a discretionary book in another — without new keys. The docs page on them is short, and every rule in it has a number. This page reproduces those rules and the two places they interact with the rest of the system: fee tiers and API wallets.

How many, and when

"Up to 10 sub-accounts can be created after reaching $100,000 in volume. Every additional $100M in volume enables the ability to create 1 additional sub-account, up to a maximum of 50 sub-accounts." Below $100,000 of volume there are none. The volume that unlocks them is the master account's; the docs do not state a per-sub-account minimum balance.

Fees: shared tier, no referral discount

"Sub-accounts share the same fee tiers as the master account, but referral discounts do not apply to sub-accounts." The fees page adds that "sub-account volume counts toward the master account and all sub-accounts share the same fee tier", so trading in a sub-account still raises the whole family's tier. If you rely on the 4% referral discount described on this site's referral page, it applies to the master account only.

Margin: always separate

Each sub-account is its own margin universe. Under cross margin collateral is shared only "between all other cross margin positions" in that account, and the portfolio-margin page is explicit that even there "sub-accounts are still treated separately under portfolio margin". A liquidation in one sub-account does not draw on another's balance. Isolated-margin positions, described on the margin-modes page, remain the tool for ring-fencing a single position inside one account.

API wallets

Automated trading uses API wallets (the API docs call them agent wallets) that sign actions on the account's behalf; what they may sign is defined in the API docs, not here. The allowance scales with sub-accounts: "the number of API wallets available starts at 3 for all master accounts and increases by 2 per sub-account". Trading via a sub-account through the API is documented under the exchange endpoint's sub-accounts and vaults section. For what an agent key can and cannot do, and how AI clients plug in, see the AI-agent trading guide.

One account-abstraction mode per account

The account abstraction mode — unified, portfolio margin or standard — is an account-level setting that "determines how spot and perps balances interact". Two limits from that page matter for multi-account setups: unified account and portfolio margin "are limited to 50k user actions per day" while "standard mode has no such restrictions", and "builder code addresses must be in standard mode to accrue builder fees". High-volume automated users are the group the docs point toward standard mode.

FAQ

Can I move funds between sub-accounts?

The docs describe sub-account transfers under the exchange API's sub-accounts and vaults section. Any action that removes margin from a position is bounded by the 10% floor described on the margin-modes page.

Do sub-accounts get the staking fee discount?

The docs tie the staking discount to the account (or a linked staking account) and say only that sub-accounts share the master's fee tier; they do not separately address staking discounts on sub-accounts. This page does not assume either way.

Is there a limit on API wallets without sub-accounts?

Three per master account. Each sub-account adds two.

Open Hyperliquid (opens in a new tab)

Referral link — 4% fee discount, disclosed on the referral page. See our methodology.