Professional XAU/USD signal system with a quant signal engine (ADX · RSI · Bollinger Bands), Telegram bot interface, and a polished Next.js dashboard. Data from Hyperliquid (free, public).
- Signal Engine — ADX(14) regime filter → RSI + Bollinger Bands validation → swing-level detection → multi-entry ladder
- On-Demand Signals — Generate from dashboard or Telegram, confirm, track in open positions, mark Won/Lost
- Session P&L Tracker — Groups consecutive signals into sessions with running P&L, R multiple, and win/loss count
- User-Controlled Sizing — Editable lot size input (0.01–1.0) with real-time margin, free margin, and pip value
- Compounding Planner — Cycle-based growth tracker with leverage settings, target goal projection, and withdrawal logging
- Candle Cache — 60s TTL cache reduces consecutive generate times from 10s to ~1s
- Telegram Bot —
/signalwith inline keyboard (Post on X / Copy / Confirm),/confirm,/brief,/log_trade,/journal,/stats,/dashboard,/clear,/help - Web Dashboard — Live chart, analytics, signal feed, trade journal, backtest simulator, compounding tracker, signals page with SignalResultCard
- Firebase Firestore — CamelCase schema syncs bot ↔ dashboard with per-user data isolation
- Responsive — Mobile-first glassmorphism design, collapsible sidebar, dark/light theme with full CSS variable system
- Social Sharing — Post signals directly to X from dashboard or bot with pre-formatted tweet text
# Bot
cd bot
pip install -r requirements.txt
uvicorn main:app --reload --port 8000
# Dashboard (separate terminal)
cd web
npm install
npm run devCopy .env.example → .env / .env.local and fill in secrets.
Bot: FastAPI · python-telegram-bot · Firebase Admin SDK · Pandas · aiohttp
Dashboard: Next.js 14 · Tailwind CSS · Recharts · Framer Motion
Data: Hyperliquid (xyz:GOLD perpetual, public API)
Database: Firestore (8 collections, camelCase schema)
Deploy: Vercel (web) · Render/Railway (bot)
├── bot/ # FastAPI backend + Telegram bot
│ ├── handlers/ # 9 Telegram command handlers (+ /confirm)
│ ├── firestore/ # Per-collection data access
│ ├── app/ # Signal engine, data client, backtester
│ └── routers/ # REST API
├── web/ # Next.js 14 dashboard
│ ├── app/dashboard/ # 10 pages (+ compounding tracker)
│ ├── app/api/ # Signal API (generate/confirm/outcome)
│ └── lib/signal-engine/ # TypeScript signal engine, indicators, candle cache
└── firestore.* # Firebase config, indexes, and security rules
| File | Purpose |
|---|---|
bot/.env.example |
Bot config template |
web/.env.example |
Dashboard config template |
Data source: Hyperliquid public Info API (unauthenticated, no API key needed).