___________________________
  __/___|___|___|___|___|___|___]=====o
 |_○_◌_◎_◌_○_◌_|
       followthedamntrain v3.0

Follow the
Damn Train

Hyperliquid-native quantitative trading framework. Real-time whale copy-trading, multi-provider AI research, derivatives analytics, and order book microstructure — all in one CLI.

Launch Dashboard →View on GitHub
199
Source Files
77
Components
17
Dashboard Pages
26
API Routes
12
Exchanges

“All you had to do was follow the damn train, CJ!” — Big Smoke

Four Pillars

Everything you need to trade

🚂

Trade Copier

Real-time Hyperliquid WebSocket monitoring. Five signal types — OPEN, CLOSE, SIZE_UP, SIZE_DOWN, FLIP. Twelve-exchange ccxt execution with automatic sizing and risk management.

  • ▸5 signal detection types
  • ▸12-exchange ccxt execution
  • ▸Hermes Agent AI pipeline
  • ▸Multi-LLM research (Claude/GPT/DeepSeek)
📊

Derivatives Analytics

Six interactive dashboard modules — volatility & variance, market positioning, options skew, events calendar, regime detection, cross-asset relative value.

  • ▸Black-Scholes engine + Greeks
  • ▸Walk-forward backtesting
  • ▸IV solver & term structure
  • ▸Sharpe stability analysis
🔬

Order Book Microstructure

Real-time L2 order book streaming. Canvas SLS heatmaps with Raw, Gravity, and Curvature modes. Ten-pair universe scanner with WebGL scatter rendering at 60fps.

  • ▸SLS heatmaps (3 modes)
  • ▸50K+ point WebGL scatter
  • ▸Depth & velocity charts
  • ▸Signal panel with Z-score ranking
📰

Live News & Alerts

Telegram channel scraper for real-time market intelligence. Alerting engine with twelve conditions and five rule types. Trade.xyz ticker integration for Hyperliquid market data.

  • ▸Telegram channel monitoring
  • ▸12 alert conditions
  • ▸localStorage headline persistence
  • ▸VaR, Sharpe & drawdown analytics

Architecture

Signal → Execute → Analyze

Hyperliquid WS ──► Signal Detection ──► Signal Router
  │  userFills          │                     │
  │  clearinghouseState │  OPEN/CLOSE/        │
  │                     │  SIZE_UP/SIZE_DOWN  │
  │                     │  FLIP               │
  │                                              │
  │              ┌───────────────────────────────┤
  │              ▼                               ▼
  │       Auto-Execute                     AI Pipeline
  │       ┌─────────────┐                 ┌─────────────┐
  │       │ Risk Manager │                 │ Hermes Agent │
  │       │ Sizing Calc  │                 │ (X, TG, Web) │
  │       │ Market Order  │                 └──────┬──────┘
  │       └──────┬──────┘                        ▼
  │              │                         LLM Analysis
  │              │                    (OpenAI/Claude/DS/Ollama)
  │              │                              │
  │              │                    ┌─────────▼─────────┐
  │              │                    │  Human-in-the-Loop │
  │              │                    │  Terminal / TG Bot  │
  │              │                    └─────────┬─────────┘
  │              │                              │
  │              └──────────────┬───────────────┘
  │                             ▼
  │                       ccxt Execution
  │                     (Hyperliquid default)
  │                             │
  │                             ▼
  │                       SQLite DB

Get Started

One command to launch

$ git clone https://github.com/ramseshk/followthedamntrain.git
$ cd followthedamntrain
$ npm install && npm run build
$ ftdt watch

┌─ smart_money_1 ───────────────────────┐
│  Value: $142,350  |  NTL: $85,000      │
│  Positions (3):                        │
│    BTC LONG ×2  $60,000  @ $105,200    │
│    ETH SHORT ×1  $15,000  @ $3,120     │
│    PURR LONG ×10  $10,000  @ $0.42     │
└────────────────────────────────────────┘
🚂 Launch App →

Requires Hyperliquid API keys • Node.js ≥20 • MIT License