lucaratiu/hyperliquid-trading-bot

This is a grid trading bot for Hyperliquid, a decentralized exchange for perpetual contracts. Grid trading is a strategy where you place a series of buy orders at prices below the current market price and sell orders above it, arranged in a grid pattern. When the price moves up or down, orders fill automatically and the bot replaces them to keep the grid in place, aiming to profit from the back-and-forth movement of prices over time. The bot is written in TypeScript and runs on Node.js version 20.19 or later. You configure it through YAML files stored in a folder called bots, where you specify the trading pair, how many grid levels to create, the price range, and various risk limits. Risk controls include a maximum drawdown percentage, a cap on how large a position can grow relative to your account, and optional stop-loss and take-profit levels. If the market price drifts far from the center of the grid, the bot can rebalance the grid automatically. Setup involves cloning the repository, installing dependencies with npm, creating a configuration file, and setting your Hyperliquid wallet private key as an environment variable. The bot supports both the Hyperliquid testnet (a practice environment with no real money) and the live mainnet. The README strongly recommends testing on testnet and with small amounts before trading real funds. When stopped with Ctrl+C, the bot cancels any open orders but leaves existing positions unchanged. Logging is configurable with four verbosity levels. The project uses the official Hyperliquid SDK for placing and tracking orders and a WebSocket connection to receive live price data. The README includes a safety note stating the software is provided for automation at the user's own risk and the authors are not responsible for trading losses. It also advises against storing private keys inside the repository.