In testing. The trading engine is not live; the console shows sample data and places no orders. Product features described here are planned.
API wallet permissions and revocation
Hyperliquid’s API wallet lets software trade for you. It is also called an agent wallet; Helmsman calls it a trading key.
Updated
On this page
The approval
Your main wallet approves a separate key pair with an off-chain signature. It costs no gas. Orders signed by that key can then act on your account.
The permission boundary
- Can
- Place and cancel orders, change leverage and margin mode, and adjust isolated margin.
- Cannot
- Withdraw, transfer, approve another API wallet or approve builder fees. These need your main wallet.
Expiry and available slots
Approvals can last up to 180 days. When one expires, its actions fail until a new approval.
An account allows one unnamed and up to three named API wallets. If those slots are used, remove an old one at app.hyperliquid.xyz → More → API.
Revoke the key
Remove the key on Hyperliquid’s API page. The app loses permission to act. Check open orders and positions on Hyperliquid and manage them there; do not rely on the app to cancel or close them after revocation. Use a fresh key for a new approval.
Check before signing
- The key can lose money by trading even though it cannot withdraw. There is no cancel-only permission.
- No legitimate app needs your main wallet’s private key or seed phrase.
- For a login signature, check the site domain. For a trading-key approval, check the key address and requested action separately.
Protocol referenceHyperliquid: API wallets and key reuse