Trading Tools & Strategies

Three open-source Hyperliquid bot examples: a 15-minute MA crossover bot, a directional funding carry bot, and a perpetual grid bot. Use referral code HIPERWIRE for 4% off trading fees.

Strategy Selection

Pick The Bot That Matches The Market Regime

These examples are intentionally narrow. The moving-average bot is a trend-following baseline, the funding bot is directional carry, and the grid bot is a range-trading template. Choosing between them starts with the market condition you want to express, not with a promise that any script is universally profitable.

Use the detail pages before running live capital. Each page documents the real command, sizing unit, startup behavior, and failure mode for its script. The goal is transparent execution you can audit and modify, not a black-box signal feed.

Selection Matrix
risk notes
Moving Average Crossover Bot

An open-source moving average crossover bot for Hyperliquid perpetuals. It uses 15-minute candles, trades in asset units, requires the symbol to be flat on startup, and waits for the next crossover before opening risk.

Watch: Whipsaws in sideways markets can stack fees and slippage quickly.

Funding Rate Carry Bot

An open-source funding rate carry bot for Hyperliquid. It is a directional perp strategy, not market-neutral arbitrage: the bot opens the side that receives funding, caps hold time, and limits concurrent positions.

Watch: This is directional carry, not market-neutral arbitrage.

Grid Bot

An open-source grid bot for Hyperliquid perpetuals. It places layered buy and sell orders around a center price, sizes in asset units, and leaves the grid shape fixed after launch.

Watch: Filled sell orders can create short perp exposure; this is not a cash-only grid.

Getting Started

Run the linked repo from its root with the actual entrypoints it exposes today.

Setup
bash

1. Clone the repo

$ git clone https://github.com/atlasdetitan/hyperliquid-trading-bots.git

$ cd hyperliquid-trading-bots

2. Install dependencies from the repo root

$ python3 -m pip install -r requirements.txt

3. Configure credentials for live trading

$ printf 'PRIVATE_KEY=0x...\\n' > .env

Set PRIVATE_KEY in .env. If you use an agent wallet, generate it at app.hyperliquid.xyz/API and add ACCOUNT_ADDRESS for the authorizing main wallet. The funding bot's --scan-only mode can skip this step.

4. Run one of the real entrypoints

Hyperliquid Moving Average Crossover Bot

$ python3 strategies/ma_crossover/bot.py --symbol BTC --fast 10 --slow 30 --size 0.001 --interval 60

Hyperliquid Funding Rate Carry Bot

$ python3 strategies/funding_arb/bot.py --threshold 0.01 --size 0.01 --interval 300 --max-positions 3 --max-hold-hours 12

Hyperliquid Grid Bot

$ python3 strategies/grid_bot/bot.py --symbol ETH --levels 10 --spacing 0.5 --size 0.01 --interval 30

Sizing is asset-based

The example bots use asset units such as BTC, ETH, or SOL size. A number that is small on one market can be large on another, so convert every command into notional exposure before running it.

Live keys deserve isolation

Use an agent wallet where possible, keep private keys out of screenshots and chat logs, and start in scan-only or tiny-size mode before letting a script place live orders.

Market structure matters

Trend, funding, and range strategies fail in different ways. Compare the strategy page risk notes with current liquidity, funding, volatility, and open interest before deploying.

DEPLOY ON HYPERLIQUID

Run these bots on the fastest on-chain perpetuals exchange