DEX

Trading bot for Hyperliquid

hamster-bot trades Hyperliquid perpetual futures with your strategies around the clock. The bot runs on your own computer or VPS, your funds stay in your wallet, and the key that signs the orders cannot withdraw them.

Download the bot for free Open Hyperliquid

Market: Perpetual futures, USDC margin
Access: API wallet that cannot withdraw
Runs on: Cross-platform, any OS
Price: Free, no limits

Why hamster-bot for Hyperliquid

A key that cannot withdraw

Hyperliquid has no API key and secret. Orders are signed by a separate API wallet that can only trade on behalf of your account.

Self-hosted

The bot runs on your own computer or server. The private key is stored only in its settings and is never sent to third-party services.

20+ strategies

Trend, counter-trend, breakout, mean reversion and TradingView signals via webhook. Strategy list.

Subaccounts and vaults

Trade on the main account, a subaccount or a vault. Leverage and margin mode (cross or isolated) are set per coin.

Many coins on one account

Each coin gets its own strategy. In mono mode, orders and positions of all strategies are fetched with one request per account.

HTTP API and MCP

Control the bot from scripts or from an AI assistant: strategies, positions, orders, logs. API documentation.

How to connect the bot to Hyperliquid

Prepare the wallet

You need a wallet you have already used to sign in at app.hyperliquid.xyz and USDC on the trading balance. The exchange does not accept an API wallet for an account without funds.
Create an API wallet

Open app.hyperliquid.xyz/API, enter a name and generate an API wallet. Save its private key: the exchange shows it only once. Confirm the link with a signature in your main wallet and choose how long it stays valid.

When it expires, the exchange starts rejecting requests. Create a new API wallet and replace the key in the bot account.

Add the account in the bot

In the web interface: Accounts → add, exchange Hyperliquid.

Field	What to enter
API key	address of the main wallet: `0x` and 40 hex characters
API secret	private key of the API wallet: 64 hex characters, with or without `0x`
API passphrase	empty. If you trade on a subaccount or a vault, its address

Do not put the main wallet's key into API secret: it gives full access to your funds. The bot needs the API wallet's key.

Set up a strategy
- exchange.name: hyperliquid;
- basic.symbol: the coin name, for example BTC. The pair list loads in the interface after you save the account;
- basic.leverage: a whole number. If it is above the coin's maximum, the bot sets the maximum and writes that to the log;
- basic.cross_margin: true for cross margin, false for isolated. If the exchange allows only isolated margin for a coin, the bot switches by itself.
Check the start

On start, the account log shows an API KEY INITIALIZED - hyperliquid block with the account address, the API wallet address, the account mode and the balance. The API Wallet address must match the API wallet address on the exchange page.

Make the first run with a small amount.

How the bot trades on Hyperliquid

Market orders

Hyperliquid has none. The bot sends an IOC limit order priced 5% worse than the mid price: it fills at once at the best prices, and the rest is cancelled.

Stop orders

Conditional orders with market execution. They trigger on the mark price; slippage tolerance after the trigger is 10%.

Minimum order

10 USDC. The exchange rejects smaller orders.

Limitations

Tester. Hyperliquid history is not downloaded: the exchange API returns only the last 5000 candles of each timeframe (about 3.5 days for 1m).

Errors in the log

Message	Cause and what to do
`User or API Wallet 0x… does not exist`	The API wallet is not linked to the account from API key, or it has expired. Compare the API Wallet address from the log with the exchange page; create a new API wallet if needed
`invalid wallet address in API key`	API key is not a wallet address
`invalid API secret`	API secret is not a private key (64 hex characters are needed)
`API secret is the private key of the main wallet`	The main wallet's key was entered. Replace it with the API wallet's key
`symbol … not found`	The symbol has a quote currency or a typo. Use the coin name: `BTC`, not `BTCUSDT`
`rate limit (HTTP 429)`	The IP request limit is exceeded. Reduce the number of strategies or the cycle frequency, turn on `mono`
`Order must have minimum value of $10`	The order is smaller than 10 USDC
`timeframe … is not supported`	The exchange does not have this timeframe, for example 6h

FAQ

Do I need an API key for Hyperliquid?

No. Hyperliquid has no API key and secret. Your account is a crypto wallet address, and trading requests are signed with the private key of a separate API wallet. You create it at app.hyperliquid.xyz/API.

Can the bot withdraw my funds?

No. An API wallet can only trade on behalf of your account; it cannot withdraw. Its key is stored only in the bot settings on your own computer or server.

Which Hyperliquid markets does the bot support?

Perpetual futures of the main perp DEX with USDC margin. Spot and third-party DEX markets (HIP-3) are not supported.

How do I write the trading pair?

As the coin name without the quote currency: BTC, ETH, SOL, kPEPE. BTCUSDT will not work.

Can I trade on a subaccount or a vault?

Yes. Put the subaccount or vault address into the API passphrase field of the bot account.

What is the minimum order size?

10 USDC. The exchange rejects smaller orders.

Does the backtester work with Hyperliquid history?

No. The exchange API returns only the last 5000 candles of each timeframe, so the tester does not download Hyperliquid history.

How much does the Hyperliquid bot cost?

hamster-bot is free with no limits. The paid version is an optional service.

Strategies

ZigZag, ZZ · ZigZag Double, ZigZag MarketOrder · Donchian Channel · Channel Close Strategy · RiskTurtle · Moving Average Crossover, Price vs MA, MACD Trend · Squeeze · RSI Pullback · DoubleDragon · MRS · MRS2, MRS2 FAST · MRS3 · HiDeep · RedFlag · SmartProfit · ShadowOverlap · TV MAPM · MZ · TradingView Webhook · Volume Market · Long/Short-bot · Close Position Delete Orders