Agent skill · marketing growth · aradotso
hyperliquid-grid-trading-bot
Configure and run an automated grid trading bot on Hyperliquid DEX with TypeScript/Node.js, supporting perpetuals and spot markets with risk management.
Why this skill is useful
Provides specific configuration patterns and commands for setting up and running a grid trading bot 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 Grid 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 with risk controls (stop loss, take profit, drawdown limits, rebalancing). Primary implementation is TypeScript/Node.js; a legacy Python tree exists for reference and learning examples. --- Install Requirements: Node.js 20.19+, a Hyperliquid wallet private key, git. Optional Python support: install uv for legacy src/ tree and learningexamples/. --- Environment Setup Edit .env — minimum required fields: Never commit .env or share your private key. Use a dedicated testnet wallet when experimenting. --- Key CLI Commands Command Purpose --------- --------- npm start Run bot using first active: true config in bots/ npm run validate Validate selected YAML config (no key required) 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 --- Bot Configuration (YAML) Configs live in bots/.yaml. Set active: true on exactly one file for auto-discovery. Full configuration reference Conservative BTC example (testnet) --- Python Legacy & Learning Examples Learning examples (educational, testnet only) --- Common Patterns Running multiple strategies Only one config should have active: true for auto-discovery. Use explicit path to run a specific config: Switching between testnet and mainnet Graceful shutdown Press Ctrl+C — the engine attempts to cancel all open orders before exiting. Always check logs to confirm cancellation completed: Validate config without credentials --- Grid Math Concepts The bot divides a price range into levels equally spaced steps: Each fill triggers the opposite order at the adjacent level, capturing the spread repeatedly. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/hyperliquid-grid-trading-bot