Trading Bot

Hyperliquid GARCH v2 quant engine, EVM insider copy trading. TypeScript, Docker, Coolify.

Strategies

Hyperliquid GARCH v2 (LIVE)

GARCH (Generalized Autoregressive Conditional Heteroskedasticity) v2 is a multi-timeframe z-score momentum engine. It detects extreme price moves by computing how many standard deviations the current momentum is from the mean, using a GARCH-style volatility model. When both the 1-hour and 4-hour timeframes show extreme z-scores simultaneously, it enters a trade expecting the momentum to continue.

Single-engine on 127 perpetual futures pairs. Real per-pair leverage (3x/5x/10x).

Engine	Entry Signal	Exit Signal	Size	Max Hold
GARCH v2 MTF	1h z>2.0 + 4h z>1.5	0.3% SL, trail 7/3->15/2->30/1	Auto (5% equity, $10-$15)	72h

How it works:

1. Every 15 minutes, compute z-score on 1h and 4h bars for each of 127 pairs
2. If 1h z-score > 2.0 AND 4h z-score > 1.5: open long
3. If 1h z-score < -2.0 AND 4h z-score < -1.5: open short
4. No EMA, BTC, regime, or volume filters (pure z-score)
5. Exit: 0.3% stop-loss (fires every 10s) or 3-stage stepped trail (fires at 1h bar boundary)
6. Hours 22-23 UTC blocked (negative expectancy)

Risk management:

• Auto-scaler: position size = 5% of equity, clamped $10-$15
• Real per-pair leverage from HL API (3x/5x/10x), capped at 10x
• Stop-loss 0.3% fixed, capped at 1.0%
• 3-stage stepped trailing: 7/3 -> 15/2 -> 30/1 (checked at 1h bar boundaries only)
• Maker entry (ALO) with taker fallback, dead-man switch
• 1h SL cooldown per pair/direction

TrumpGuard

Monitors Trump Truth Social, Fed FOMC, Powell, White House RSS feeds. Opens paper positions on BTC/ETH/SOL on HIGH impact events. Does not close live positions.

Insider Copy Trading (EVM)

Copies EVM token buys from high-scoring insider wallets.

• Real-time buy/sell detection via Alchemy WebSocket
• 47 tracked wallets on Ethereum
• GoPlus security checks, $20k min liquidity
• Dynamic position sizing: $3-$20 based on score
• Rug detection via burn events + liquidity monitoring

Unified Account (Hyperliquid)

• getSpotClearinghouseState returns real portfolio value
• When perps equity <= marginUsed, use spot USDC as equity

Trading Modes

	Paper	Hybrid	Live
Quant Ensemble	Paper	Live	Live
Insider Copy	Paper	Paper	Live
Set via	TRADING_MODE=paper	TRADING_MODE=hybrid	TRADING_MODE=live

Telegram

Command	Description
/balance	Portfolio value
/pnl	P&L with period tabs
/trades	Open positions
/insiders	Insider wallets
/stop / /resume	Kill switch
/mode	Switch trading mode

Config

Variable	Default	Description
TRADING_MODE	paper	paper, hybrid, or live
QUANT_ENABLED	false	Enable quant trading
DAILY_LOSS_LIMIT_USD	$25	Daily loss limit per strategy

Required: TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID

Optional: HYPERLIQUID_PRIVATE_KEY, HYPERLIQUID_WALLET_ADDRESS, PRIVATE_KEY_EVM, ETHERSCAN_API_KEY, ALCHEMY_API_KEY

Setup

npm install
cp .env.example .env
npm run dev

Deployment (Coolify)

1. Set environment variables in dashboard
2. Mount /data volume for SQLite persistence
3. Health check: GET /health on port 4000

Tech Stack

TypeScript (strict), Node 22, Vitest, SQLite, Grammy, ethers.js, Hyperliquid SDK, Docker, Coolify

License

MIT