Hyperdaily guide

Hyperliquid agent wallet vs master wallet

An agent wallet signs trading actions for an account. It is different from the master wallet, but it is still a real permission that deserves caps, records, and a revoke path.

Run the read-only check

Public address only. No private keys, no agent wallet, no signing during the scan.

The master wallet owns the decision

The master account is the address whose positions and balances the Info API returns. A common integration mistake is querying the agent address and getting an empty or misleading account view.

The agent wallet signs actions

approveAgent registers an API wallet that can sign on behalf of the master or a subaccount. That permission can be useful for automation, but it should never be confused with read-only wallet intelligence.

Cannot withdraw does not mean cannot lose

An API wallet cannot withdraw funds, but it can still place or cancel trades after approval. Set notional, size, and daily caps, keep a kill switch, and make revoke easy to find.

FAQ

Is an agent wallet the same as the master wallet?

No. The master wallet is the account being queried and controlled by the user. The agent wallet is an approved API signer for trading actions.

Can a Hyperliquid agent wallet withdraw funds?

The official API wallet flow does not allow withdrawals, but the wallet can still trade after approval.

What should happen before approveAgent?

Show the agent address, name, scope, caps, expiry or kill-switch policy, and the revoke path before requesting a signature.

Primary sources

Keep reading

Turn this guide into a wallet briefing.

Scan a Hyperliquid wallet