MEXC futures trading bot

TypeScript Node CLI for rule-based automation on MEXC USDT-margined perpetual contracts (contract.mexc.com). Ships with moving-average crossover and grid strategies, dry-run mode, and notional risk caps.

Requirements

• Node.js 20+
• MEXC futures account with either Open API credentials (MEXCAPIKEY + MEXCAPISECRET) or a web session key/cookie pair
• Sufficient USDT margin for the configured symbol and leverage

Setup

cp .env.sample .env
npm install

Commands

| Command | Description | |---------|-------------| | npm run bot | Long-running strategy loop (BOTDRYRUN=true recommended first). | | npm run build | Emit dist/. | | npm run typecheck | tsc --noEmit. |

Strategies

• ma-cross (default): 9/21 SMA crossover filtered by RSI; closes on opposite cross.
• grid: Places conceptual buy bands below spot and takes profit toward upper grid levels.

Safety

Always start with BOTDRYRUN=true. Perpetual futures carry liquidation risk—RISKMAXPOSITIONUSDT and RISKRISK_PERCENT cap sizing but do not guarantee profitability.

See docs/architecture.md for request flow notes.

License

MIT — see LICENSE.