Hyperliquid Trading Bot

This is a grid trading bot for Hyperliquid DEX that places layered buy/sell orders around a price range, with configurable stop loss, take profit, and drawdown limits. The TypeScript implementation runs on Node 20.19+ and uses YAML configs to define grid levels, risk rules, and rebalancing thresholds. It includes Python learning examples for websockets and order placement if you want to understand the Hyperliquid API before running the full bot. The testnet workflow is solid: validate your config, fund via faucet, watch logs, then flip to mainnet only when you're confident. Graceful shutdown tries to cancel open orders on exit, but you should still verify in the UI. Start with a conservative max_allocation_pct and test rebalancing behavior before letting it run unsupervised.

skills.sh installs: 178
GitHub stars: 26
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add aradotso/trending-skills --skill hyperliquid-trading-bot --agent claude-code

Installs into .claude/skills of the current project.

Files

Hyperliquid Trading Bot

Skill by ara.so — Daily 2026 Skills collection.

A configurable grid strategy runner for Hyperliquid DEX. Places layered buy/sell orders around a price range and enforces risk rules (stop loss, take profit, drawdown limits, rebalancing). Primary stack is TypeScript on Node.js 20.19+; a legacy Python tree exists for reference and learning examples.

Installation

git clone https://github.com/PolyPulse-Analytics/hyperliquid-trading-bot.git
cd hyperliquid-trading-bot
npm install

Requirements

Node.js 20.19+
A Hyperliquid wallet private key (use a dedicated testnet key to start)
git

Optional for Python examples: uv

Environment Setup

cp .env.example .env

Edit .env — minimum required keys:

# Testnet (recommended to start)
HYPERLIQUID_TESTNET_PRIVATE_KEY=0xYOUR_TESTNET_PRIVATE_KEY_HERE
HYPERLIQUID_TESTNET=true

# Mainnet (real funds — set carefully)
# HYPERLIQUID_MAINNET_PRIVATE_KEY=0xYOUR_MAINNET_PRIVATE_KEY_HERE
# HYPERLIQUID_TESTNET=false

Never commit .env or share your private key.

SKILL.md on GitHub