What is hyperliquid-trading-bot?

This repository is a trading bot that runs automated buy and sell orders on Hyperliquid, a crypto exchange that specializes in perpetual contracts. A perpetual contract is a type of trade where you bet on whether an asset's price will go up or down, without owning the asset itself. The bot uses a strategy called grid trading, which involves placing a set of buy and sell orders at evenly spaced price levels across a range. When the price bounces up and down within that range, the bot collects the difference between its buy and sell prices repeatedly. Setting up the bot does not require editing any code. All the trading parameters live in a YAML file: you choose which asset to trade, how many price levels to create, and whether to set the price range manually or let the bot calculate it automatically as a percentage around the current market price. Risk controls are also configured in that same file, including a maximum drawdown limit that halts new orders if losses exceed a threshold, a cap on how large the overall position can grow, and optional stop-loss and take-profit levels. The bot connects to Hyperliquid via a live price feed and a REST interface for placing orders. When the price moves far enough that the grid becomes unbalanced, the engine rebalances the orders. When you stop the bot with Ctrl+C, it cancels all open orders but does not automatically close any open positions, so you need to check your exposure manually before shutting down. The setup requires Node.js version 20.19 or later. After cloning the repository and installing dependencies, you put your Hyperliquid private key in an environment file and point the bot at one of the included YAML config examples. The README specifically recommends starting on the testnet, which is a version of the exchange that uses fake funds, before running with real money. Private keys give full account access, so the README cautions against storing them inside the repository. The code is written in TypeScript and licensed under Apache 2.0. It is structured for solo or small-team use: one config file per bot strategy, a simple command-line interface, and no external database or cloud dependency.