Source: https://hamster-bot.com/en/exchange/hyperliquid

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](https://hamster-bot.com/en/download) [Open Hyperliquid](https://app.hyperliquid.xyz)

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](https://hamster-bot.com/en/algo).

### 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](https://hamster-bot.com/en/api).

## How to connect the bot to Hyperliquid

1. ### Prepare the wallet
   You need a wallet you have already used to sign in at [app.hyperliquid.xyz](https://app.hyperliquid.xyz) and USDC on the trading balance. The exchange does not accept an API wallet for an account without funds.
2. ### Create an API wallet
   Open [app.hyperliquid.xyz/API](https://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.
3. ### 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.
4. ### 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.
5. ### 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](https://hamster-bot.com/en/algo/zigzag) · [ZigZag Double, ZigZag MarketOrder](https://hamster-bot.com/en/algo/zigzag-double) · [Donchian Channel](https://hamster-bot.com/en/algo/donchianchannel) · [Channel Close Strategy](https://hamster-bot.com/en/algo/tv-ccs) · [RiskTurtle](https://hamster-bot.com/en/algo/riskturtle) · [Moving Average Crossover, Price vs MA, MACD Trend](https://hamster-bot.com/en/algo/movingaveragecrossover) · [Squeeze](https://hamster-bot.com/en/algo/squeeze) · [RSI Pullback](https://hamster-bot.com/en/algo/rsipullback) · [DoubleDragon](https://hamster-bot.com/en/algo/doubledragon) · [MRS](https://hamster-bot.com/en/algo/mrs) · [MRS2, MRS2 FAST](https://hamster-bot.com/en/algo/mrs2) · [MRS3](https://hamster-bot.com/en/algo/mrs3) · [HiDeep](https://hamster-bot.com/en/algo/hideep) · [RedFlag](https://hamster-bot.com/en/algo/redflag) · [SmartProfit](https://hamster-bot.com/en/algo/smartprofit) · [ShadowOverlap](https://hamster-bot.com/en/algo/shadowoverlap) · [TV MAPM](https://hamster-bot.com/en/algo/tv-mapm) · [MZ](https://hamster-bot.com/en/algo/mz) · [TradingView Webhook](https://hamster-bot.com/en/algo/tv) · [Volume Market](https://hamster-bot.com/en/algo/volumemarket) · [Long/Short-bot](https://hamster-bot.com/en/algo/tv-lsb) · [Close Position Delete Orders](https://hamster-bot.com/en/algo/closepositiondeleteorders)

## Start the bot on Hyperliquid

Download hamster-bot, add your API wallet and turn on the first strategy.

[Download the bot](https://hamster-bot.com/en/download) [Instructions](https://hamster-bot.com/en/bot) [Videos](https://hamster-bot.com/en/video)

[Other exchanges](https://hamster-bot.com/en/exchange): [Bybit](https://hamster-bot.com/en/exchange/bybit) · [Binance](https://hamster-bot.com/en/exchange/binance) · [OKX](https://hamster-bot.com/en/exchange/okx) · [Bitget](https://hamster-bot.com/en/exchange/bitget) · [BingX](https://hamster-bot.com/en/exchange/bingx) · [BTSE](https://hamster-bot.com/en/exchange/btse)

[Compared with cloud bots](https://hamster-bot.com/en/alternative): [3Commas](https://hamster-bot.com/en/alternative/3commas) · [Bitsgap](https://hamster-bot.com/en/alternative/bitsgap) · [Cryptohopper](https://hamster-bot.com/en/alternative/cryptohopper)
