← Back to dashboard
hyperweave — Setup guide
Everything you need to launch your first agent: a funded
Hyperliquid testnet wallet, an API key, and a DeepSeek key.
⚠️ This is a testnet research environment — agents trade
with mock funds, not real money. Your keys are encrypted at rest and
never shared; the API/agent key you provide is trading-only and cannot
withdraw funds.
1. Create & fund a Hyperliquid testnet wallet
- Go to app.hyperliquid-testnet.xyz
and connect a wallet (a fresh MetaMask account, or "Log in with Email").
- Unlock the faucet. The testnet faucet only works once your address
has made a deposit on mainnet. If the faucet says "does not exist
on mainnet", do a tiny one-time deposit (≈5 USDC on Arbitrum) at
app.hyperliquid.xyz
→ Deposit. (That USDC stays in your account — you're only spending a
little gas.)
- Back on testnet, open the Faucet tab and claim 1,000 mock USDC.
- The faucet credits your Spot wallet, but agents trade Perps —
so move the funds: open the Spot↔Perp Transfer and send the USDC to
Perp.
No fresh funds? You can also receive testnet USDC from another
funded account via Hyperliquid's Send USDC.
2. Create an API (agent) wallet
- On the testnet app, go to More → API.
- Generate an API wallet and authorize it (sign with your main
wallet). This produces an API private key — copy it.
- You'll paste two things into the launcher: your main account address
(holds the funds) and the API wallet private key (does the trading,
can't withdraw).
3. Get a DeepSeek API key
- Sign up at platform.deepseek.com,
add a little credit, and create an API key (
sk-…).
- You bring your own key, so you pay only for your own agent's LLM
calls (typically pennies per day at low cadence).
- Tip: save the key once on your
Profile page and every new
agent will use it automatically — no need to paste it each time.
4. Define your agent
On the Agents page, click
+ Add an agent and fill in the short wizard:
| Name | A label for this agent (also its dashboard tag). |
| DeepSeek key | From step 3 — or save one on your
Profile and leave this blank. |
| Wallet + API key | Optional. Add the main address + API
private key (steps 1–2) only if you want this agent to trade live; a
backtest never needs a wallet. |
| Coins | Which perps it may trade (pick a few liquid ones to start). |
| Timeframe | The candle intervals the model sees (intraday + longer context). |
| Cycle interval | How often it decides when live (minutes). Slower = fewer fees. Backtests ignore this. |
| Backtest span | How many days of history a backtest of this agent replays. |
| Inputs | Toggle which data the model gets (funding, open interest, indicators…). |
| System prompt | Prefilled with the default; edit it to shape the strategy. |
5. Run it: go live or backtest
A saved agent is a reusable definition. From its row in Your agents:
- Go live — starts trading your testnet wallet within ~a minute (needs a
wallet). Stop returns it to idle; open positions remain on the wallet.
Up to 6 live agents per account.
- Backtest — replays the agent over real historical candles on a
simulated venue; results land on your
Replays page. It returns to
idle when done, so you can run it again or tweak and re-run.
- Experiment: tick several agents and hit Backtest selected to
run them together and compare on the Replays page.
Heads-up: an agent's directional calls are only as good as the
model + prompt — these strategies have real drawdowns. Start small.
→ Go to the launcher