Hyperliquid
| Property | Value |
|---|---|
| Transport | WebSocket (order placement + market data) |
| Signing | EIP-712 (agent wallet) |
| Funding interval | 1 hour |
| Concurrent Spreadr maker trades | 2 per account (shared with trade[xyz]; subject to change) |
| Builder code support | ✅ — 0.5 bp via builder address |
Account setup
Hyperliquid uses an agent wallet model: your real (parent) wallet authorizes a separate agent wallet to sign orders on its behalf. Spreadr generates the agent for you — there are no keys to copy.
Open an account
Visit app.hyperliquid.xyz (opens in a new tab) and connect with your parent wallet. Deposit USDC if you haven't already.
Connect in Spreadr
In the terminal: Settings → Wallets, pick your wallet, then + Hyperliquid → Generate & Approve Agent. Spreadr generates the agent key in your browser and asks you to sign 3 messages: the agent authorization, the builder-fee authorization, and the credential vault unlock. Nothing to copy or paste.
The agent has trade-only access — it can place and cancel orders, but cannot withdraw funds. Your parent wallet's address (public) is used to subscribe to your fills and account state; its private key never leaves your wallet.
This connection also covers trade[xyz], which runs on Hyperliquid.
Quirks
- Withdrawals safe even on key leak: The agent key cannot move funds — only the parent can withdraw. Worst case if your agent leaks: malicious trades against your collateral, but no theft.
- WebSocket disconnects: Spreadr cancels all open orders on disconnect, reconnects, then resumes the trade where it left off.
- Signing split: the one-time approvals at setup are signed by your own wallet in the browser; per-order signing during trades happens server-side with the agent key.
- Batched cancels: cancel-alls are batched into single requests for faster unwinds; order placement is one order per request.
Builder fees
Spreadr is registered as a HL builder, taking 0.5 bp (0.005%) on each fill it routes for you. This shows up on Hyperliquid's side as a builder fee, deducted from your fill price.
Common errors
| Symptom | Cause | Fix |
|---|---|---|
| "Agent not authorized" | The agent approval is missing or was revoked | Delete the Hyperliquid credential in Spreadr and reconnect to re-run the approval |
| "Rate limit exceeded" | Request budget exhausted | Wait a moment; Spreadr's rate limiter recovers automatically |
| "Concurrent order limit reached" | You already have 2 active Spreadr maker trades on this account | Close one to free a slot |
| "Insufficient margin" | Account collateral too low for the position | Deposit more USDC or reduce leverage cap |
| Missing fills in app UI | Browser cached an old session | Hard-refresh (Cmd-Shift-R) |