Agent skill · software engineering · aradotso
hyperliquid-trading-bot
Configurable grid trading bot for Hyperliquid DEX with TypeScript/Node.js primary implementation, supporting perpetuals and spot markets with risk management features.
Why this skill is useful
Provides specific configuration patterns and commands for automating trading on Hyperliquid DEX that the AI wouldn't reliably generate on its own.
What it needs
Requires git, node installed locally. Requires hyperliquid account access. About 4k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
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 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 Edit .env — minimum required keys: Never commit .env or share your private key. --- Key Commands Command Purpose --- --- npm start Run bot using first active: true config in bots/ npm run validate Validate YAML config structure (no private key needed) npm test Run automated tests (grid math, etc.) npx tsc --noEmit TypeScript type check npx tsx ts/src/runBot.ts path/to/config.yaml Run with explicit config file Explicit config path (recommended for multi-bot setups) Graceful shutdown Press Ctrl+C — the engine attempts to cancel all open orders before exiting. Always review logs to confirm cancellation. --- Bot Configuration (YAML) Config files live in bots/.yaml. Only one file should have active: true when using auto-discovery via npm start. Full annotated example Manual price range example --- Common Patterns Running multiple bots with different configs Do not use active: true — call each explicitly: Validate before running (CI/pre-flight) Testnet workflow before going live 1. Set HYPERLIQUIDTESTNET=true in .env 2. Set exchange.testnet: true in your YAML 3. Fund via Hyperliquid testnet faucet 4. Run npm run validate then npm start 5. Watch logs — verify orders appear in testnet UI 6. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/hyperliquid-trading-bot