amet2901/asterdex-trading-bot

This is an automated trading bot for cryptocurrency perpetual contracts, designed to work with three exchanges: AsterDex, GRVT, and Hyperliquid. Perpetual contracts are a type of derivative that lets traders speculate on the price of an asset like Bitcoin without owning it directly. The bot runs on your own computer or server and places buy and sell orders automatically based on rules you configure. It ships with two built-in trading strategies. The first is a trend-following strategy that uses a 30-period moving average to decide when to enter a trade, combined with a trailing stop and a filter based on price volatility. The second is a market-making strategy that continuously places orders on both sides of the order book, aiming to profit from the spread between buy and sell prices. Both strategies track open positions and risk limits in real time and can recover their state automatically if the program restarts. Setup involves cloning the repository, installing the Bun JavaScript runtime, copying an example configuration file, and filling in your exchange API keys and trading parameters. The configuration file controls things like which asset to trade, the maximum loss allowed per trade, order sizes, and timing. Once running, a terminal-based menu lets you pick a strategy interactively. You can also skip the menu and start a strategy directly from the command line in silent mode, which is useful for running the bot as a background process using a tool called pm2. The README notes several practical requirements before going live: you need at least 50 to 100 USDT of available capital, you must set your leverage on the exchange manually before starting (around 50x is suggested), and your system clock should be accurate to avoid authentication errors. For Hyperliquid, the bot uses a wallet private key directly, so the README specifically advises using a dedicated trading wallet rather than a primary one. The project includes a disclaimer that algorithmic trading carries real financial risk and recommends testing with paper accounts or small amounts before committing real capital.