novaquant-labs/hyperliquid-trading-bot

This is an automated grid trading bot for Hyperliquid, a decentralized platform for trading cryptocurrency derivatives. Grid trading is a strategy where you place a series of buy orders below a price and sell orders above it, at evenly spaced intervals, and then collect small profits each time the market moves up or down and hits one of your orders. This bot handles that process automatically, placing the orders, watching for fills, and rebalancing the grid as the market moves. The README leads with a prominent risk warning: trading derivatives can result in losing your entire investment, and the authors describe the project as being for education and research. They recommend starting on a testnet, which uses fake funds, before connecting real money. Setup takes a few steps. You clone the repository, install dependencies with npm, copy an environment file template and add your wallet's private key, and then edit a YAML configuration file to define your strategy. The config file controls which token you are trading, how many price levels your grid spans, how wide the price range is, and several risk limits: the maximum percentage of your wallet the bot can use, a drawdown threshold at which the bot pauses, and optional stop-loss and take-profit levels. The README includes example configurations for conservative, balanced, and aggressive risk appetites. The bot runs continuously once started, checking for order fills and adjusting the grid on a loop. Pressing Ctrl+C cancels all open orders and stops the bot. The README walks through a concrete example with actual price numbers to show exactly what the grid looks like in practice: if a token is trading at a given price, the bot places five buy orders below and five sell orders above at calculated intervals. The bot is built on Node.js and runs on both testnet and mainnet depending on your configuration. The repository also includes Python example scripts described as educational tools for learning the Hyperliquid API.