A multi-exchange perpetuals market maker bot supporting Aftermath Perpetuals (Sui) and Hyperliquid, using Binance or Hyperliquid as the price oracle.
- Multi-exchange support - Trade on Aftermath or Hyperliquid with a unified interface
- Configurable price oracle - Use Binance spot or Hyperliquid perps for fair price
- EMA-based fair pricing - Smooth price calculation with configurable window
- Position risk management - Close mode with reduce-only orders when position exceeds threshold
- Real-time monitoring - TUI monitor for orderbook and position visualization
- Graceful shutdown - Cancels all orders on exit
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env
# Edit .env with your keys
# Run on Hyperliquid
npm run bot -- --exchange hyperliquid --symbol BTC
# Run on Aftermath
npm run bot -- --exchange aftermath --symbol BTC
# Monitor market data
npm run monitor -- --exchange hyperliquid --symbol BTC
| Variable |
Description |
EXCHANGE |
Exchange: aftermath or hyperliquid |
SYMBOL |
Trading symbol (e.g., BTC, ETH) |
| Variable |
Description |
SUI_PRIVATE_KEY |
Sui wallet private key (base64 or hex) |
| Variable |
Description |
HL_PRIVATE_KEY |
EVM private key (0x-prefixed hex) |
HL_TESTNET |
Use testnet: true or false |
| Variable |
Default |
Description |
PRICE_SOURCE |
binance |
Price oracle: binance or hyperliquid |
SPREAD_BPS |
10 |
Spread in basis points (10 = 0.1%) |
ORDER_SIZE_USD |
100 |
Order size in USD |
CLOSE_THRESHOLD_USD |
500 |
Switch to close mode threshold |
MAX_POSITION_USD |
2000 |
Maximum position before stopping |
WARMUP_SECONDS |
10 |
Wait before quoting |
LOG_LEVEL |
info |
Logging level |
npm run bot -- [options]
Options:
-e, --exchange <exchange> Exchange (aftermath, hyperliquid)
-s, --symbol <symbol> Trading symbol (BTC, ETH, etc.)
-p, --price-source <source> Price oracle (binance, hyperliquid)
--spread-bps <bps> Spread in basis points
--order-size <usd> Order size in USD
--close-threshold <usd> Close mode threshold
--max-position <usd> Maximum position
--warmup <seconds> Warmup period
src/
├── bots/mm/ # Market maker bot
│ ├── index.ts # Main loop
│ ├── config.ts # Configuration
│ ├── position.ts # Position tracking
│ └── quoter.ts # Quote generation
├── cli/ # Entry points
│ ├── bot.ts # Bot CLI
│ └── monitor.ts # Market monitor
├── exchanges/ # Exchange adapters
│ ├── types.ts # IExchange interface
│ ├── aftermath/ # Sui perpetuals
│ └── hyperliquid/ # Hyperliquid
├── pricing/ # Price feeds
│ ├── binance.ts # Binance WebSocket
│ ├── hyperliquid.ts # Hyperliquid mid prices
│ └── fair-price.ts # EMA calculator
└── types.ts # Shared types
┌─────────────────────────────────────────────────────────────────────────────┐
│ MARKET MAKER BOT │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌──────────────────┐ ┌─────────────────┐ │
│ │ BINANCE │ ──WS──▶ │ FAIR PRICE │ │ AFTERMATH / │ │
│ │ (spot) │ ticks │ CALCULATOR │ │ HYPERLIQUID │ │
│ └─────────────┘ │ │ │ (perps) │ │
│ or │ price ──▶ EMA │ └────────┬────────┘ │
│ ┌─────────────┐ │ │ │ │
│ │ HYPERLIQUID │ ──WS──▶ │ $98,420.50 │ │ │
│ │ (perps) │ mids └────────┬─────────┘ │ │
│ └─────────────┘ │ │ │
│ ▼ │ │
│ ┌──────────────────┐ │ │
│ │ QUOTER │ │ │
│ │ │ │ │
│ │ spread: 10 bps │ │ │
│ │ │ │ │
│ │ BID: $98,410.68 │───── place ──────▶│ │
│ │ ASK: $98,430.32 │ orders │ │
│ └────────┬─────────┘ │ │
│ │ │ │
│ ▼ │ │
│ ┌──────────────────┐ │ │
│ │ POSITION MANAGER │◀──── positions ───┤ │
│ │ │ │ │
│ │ notional: $500 │ │ │
│ │ close mode: ON │ │ │
│ │ margin: 45% │ │ │
│ └──────────────────┘ │ │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
FLOW:
1. Stream prices from Binance/Hyperliquid
2. Calculate fair price using EMA
3. Generate bid/ask quotes with spread
4. Place orders on target exchange
5. Monitor position & margin for risk
6. Switch to close mode when overleveraged
- Connect - Establishes connection to exchange and price feed
- Warm up - Collects price data to initialize EMA (default: 10s)
- Quote - Places bid/ask orders around fair price with spread
- Manage risk - Monitors position, switches to close mode when threshold exceeded
- Repeat - Continuously updates quotes as price moves
When position notional exceeds closeThresholdUsd:
- Uses tighter spread (
takeProfitBps instead of spreadBps)
- Only quotes on the reducing side (asks for long, bids for short)
- Orders are marked
reduceOnly
closeThresholdUsd - Switch to close modemaxPositionUsd - Stop opening new positions entirely
# Build image
docker build -t aftermath-mm .
# Run Hyperliquid bot
docker compose --profile hyperliquid up -d
# Run Aftermath bot
docker compose --profile aftermath up -d
# Run both
docker compose --profile all up -d
# View logs
docker compose logs -f
# Lint
npm run lint
# Type check
npm run build
# Test
npm test
# Watch mode
npm run dev -- --exchange hyperliquid --symbol BTC
⚠️ This is trading software. Use at your own risk.
- Liquidation - Monitor margin ratio, bot doesn't check this
- Stale prices - Network latency affects quote accuracy
- Exchange issues - API failures can leave orders orphaned
- Bugs - Software may have undiscovered issues
MIT