metanode-trade/asterdex-trading-bot

This repository is a trading bot written in TypeScript that places automated buy and sell orders on three cryptocurrency exchanges: Aster DEX, GRVT, and Hyperliquid. All three are perpetual futures exchanges, meaning they offer contracts that let you speculate on whether an asset's price will rise or fall without owning the asset. You switch between exchanges by changing a single configuration value. The bot offers three trading strategies. The trend strategy looks for directional price moves using a technical indicator called Bollinger Bands, then follows the move and exits with a trailing stop that locks in profit as the price continues in your favor. The maker strategy posts limit orders on both sides of the market to collect the spread, refreshing and chasing the price when it moves away. The offset maker strategy works similarly but adjusts quote distances dynamically based on the midpoint price. You choose which strategy to run as a command-line argument when starting the bot. The terminal interface is a live dashboard built with a library called Ink, which renders React components in the command line. It shows your current positions, profit and loss, and the engine's operating state. For server deployments where you do not want a visual interface, a silent mode is available, and the bot supports PM2, a common Node.js process manager used to keep applications running reliably on a server. Setup requires Node.js version 20 or later. After cloning and installing dependencies, you copy an example environment file and fill in your API keys for whichever exchange you want to use. The bot requires your exchange account to be in one-way position mode and does not set leverage automatically, so you need to configure that on the exchange manually before running. The README includes a standard disclaimer that perpetual futures carry liquidation risk and that the authors are not liable for trading losses. API keys should be created with trade-only permissions, without withdrawal access. The project includes a test suite using Vitest and is licensed under terms not explicitly stated in the README.