Skip to main content
Learn how to use agent wallets (API wallets) to build secure, scalable trading systems on Hyperliquid with Privy.
Before continuing with this guide, make sure you have initialized your Hyperliquid client as shown in the Getting Started guide. This guide assumes you have client and other basic setup completed.

Overview

Agent wallets (also known as API wallets) are permissioned signers that do not hold funds but can execute Hyperliquid actions for a master account and its subaccounts. This lets you:
  • Keep user keys isolated while trading programmatically
  • Give each bot or trading strategy its own nonce space
  • Simplify concurrent trading operations
  • Easily rotate keys without affecting trading
  • Preserve consolidated fee tiers and account-level PnL

Creating an Agent Wallet

Using an Agent Wallet

Once registered, the agent wallet can execute trades on behalf of the master account:

Setting Agent Expiration

You can set an expiration timestamp for agent wallets using the agent name:

Listing Agent Wallets

Retrieve all registered agents for a master account:

Best Practices

Create separate agent wallets for each trading strategy or bot. This isolates nonce management and makes it easier to track which system placed which orders.
For automated trading systems, set reasonable expiration times on agent wallets to limit exposure if a key is compromised.
Regularly audit which agent wallets are registered and revoke access for agents that are no longer needed.

Next Steps

Subaccounts

Learn how to use subaccounts for risk isolation

Executing trades

Learn common trading patterns and order types