Crypto quantitative trading platform for Binance USDM Futures.
Full-stack algorithmic trading system with signal generation, strategy backtesting, bot execution, real-time market data, and comprehensive analytics. Built with Python/FastAPI backend and Next.js/React frontend.
- Signal Terminal — Real-time trade signal feed with multi-strategy scoring, R:R ratios, filtering by grade/direction/status, expandable detail panels with strategy scores and market context
- Trading Bot — Paper + Live mode, configurable strategies, SL/TP management with trailing stops, paper balance persistence across restarts
- TradingView Chart — Candlestick chart with 16 technical indicators, live order book (20 levels), infinite scroll history, bottom trading panel (Positions/Orders/Trade History/Place Order)
- Position Manager — Live Binance positions with real-time P&L, trade history with expandable details (close reason, holding time, fees), strategy name tracking
- Wallet — Multi-wallet balance overview, internal transfers, margin analysis
- Backtesting — Historical strategy simulation with 10 interactive Recharts charts (equity curve, drawdown, rolling Sharpe, P&L scatter, win/loss distribution, P&L by direction, consecutive streaks, cumulative fees, duration vs P&L, monthly returns), multi-verification cross-checks, CSV export
- Strategy Comparison — Dedicated comparison page: overlay equity curves, metrics table with best/worst highlighting, drawdown comparison across up to 4 backtests
- Analytics — Real performance metrics from closed positions (Sharpe, Sortino, profit factor, equity curve), interactive Recharts charts with hover tooltips, CSV export
- DCA / Average Down — Fully configurable dollar cost averaging: trigger %, qty multipliers per level, SL/TP recalculation modes, risk budget enforcement
- Notifications — Real-time bell notifications from WebSocket events (signals, position opens/closes, bot status changes, errors)
- Settings — Tabbed settings: Exchange API, Risk Management, DCA, Execution Policy (strategy/grade matrix), Alerts (Telegram/Discord), Security (change password, session info)
- System Monitoring — Component health (DB, Redis, Exchange, WebSocket, Bot), latency tracking, error alerts
- Security — JWT auth with bcrypt, rate limiting (300/min general, 10/min auth), CORS protection, encrypted API keys, WebSocket JWT auth
| Login | Dashboard | Signal Terminal |
|---|---|---|
 |
|
 |
| Bot Manager | Position Manager | Wallet |
|---|---|---|
 |
 |
 |
| Chart | Analytics | Backtest |
|---|---|---|
 |
 |
 |
| Settings | System Status |
|---|---|
 |
 |
| Backtest Results | Strategy Comparison |
|---|---|
 |
 |
graph TB
subgraph Frontend["Frontend (Next.js 15)"]
UI[App Router Pages]
WS_Client[WebSocket Client]
API_Client[REST API Client]
end
subgraph Backend["Backend (FastAPI)"]
API[REST API + JWT Auth]
WSB[WebSocket Bridge]
BOT[BotService Orchestrator]
SIG[Signal Aggregator]
EXEC[Execution Engine]
RISK[Risk Manager]
IND[Indicator Pipeline]
BT[Backtest Engine]
end
subgraph Strategies["6 Trading Strategies"]
S1[Momentum]
S2[Mean Reversion]
S3[Smart Money / SMC]
S4[Volume Analysis]
S5[Funding Arbitrage]
S6[Order Block Zones]
end
subgraph ML["ML Pipeline"]
XGB[XGBoost]
GRU[GRU Neural Net]
ONNX[ONNX Runtime]
ENS[Ensemble Scorer]
end
subgraph Infra["Infrastructure"]
TSDB[(TimescaleDB)]
REDIS[(Redis Pub/Sub)]
BN[Binance USDM API]
end
UI --> API_Client --> API
UI --> WS_Client --> WSB
API --> BOT
BOT --> SIG --> S1 & S2 & S3 & S4 & S5 & S6
SIG --> ENS --> XGB & GRU & ONNX
BOT --> EXEC --> BN
BOT --> RISK
API --> BT
IND --> SIG
WSB --> REDIS
API --> TSDB
BOT --> REDIS
EXEC --> TSDB
sequenceDiagram
participant BN as Binance WS
participant DP as Data Provider
participant IP as Indicator Pipeline
participant ST as Strategies (6x)
participant SA as Signal Aggregator
participant ML as ML Ensemble
participant RM as Risk Manager
participant EX as Executor
participant DB as TimescaleDB
BN->>DP: Candle + Orderbook Stream
DP->>IP: Normalized OHLCV
IP->>ST: 16 Indicators Computed
ST->>SA: RawSignal (direction, SL, TP)
SA->>ML: Aggregate + ML Confidence
ML->>SA: Ensemble Score (0-1)
SA->>RM: Graded Signal (A/B/C/D)
RM->>EX: Risk-Approved Signal
EX->>BN: Place Order (CCXT)
EX->>DB: Persist Position
EX-->>DP: Position Update Event
erDiagram
USERS {
uuid id PK
string username UK
string hashed_password
timestamp created_at
}
BOT_STATE {
uuid id PK
boolean is_running
jsonb active_strategies
string trading_mode
float paper_balance
jsonb metadata
timestamp updated_at
}
POSITIONS {
uuid id PK
string symbol
string direction
float entry_price
float quantity
float stop_loss
float tp1_price
float tp2_price
float tp3_price
string status
string trading_mode
float unrealized_pnl
float total_fees
timestamp opened_at
timestamp closed_at
}
SIGNALS {
uuid id PK
string symbol
string direction
string signal_grade
float signal_strength
float entry_price
float stop_loss
jsonb strategy_scores
string status
string outcome
timestamp created_at
}
ORDERS {
uuid id PK
uuid position_id FK
string symbol
string side
string order_type
float quantity
float price
string status
timestamp created_at
}
CANDLES {
timestamp time PK
string symbol PK
string timeframe PK
float open
float high
float low
float close
float volume
}
BACKTESTS {
uuid id PK
string strategy
string symbol
string timeframe
jsonb config
jsonb results
timestamp created_at
}
SETTINGS {
uuid id PK
string exchange
jsonb risk_params
jsonb notification_config
jsonb signal_policy
timestamp updated_at
}
POSITIONS ||--o{ ORDERS : "has"
SIGNALS ||--o| POSITIONS : "generates"
| Layer | Technology |
|---|---|
| Frontend | Next.js 15.5, React 19, TailwindCSS 4, TradingView Lightweight Charts 5 |
| Backend | Python 3.13, FastAPI, SQLAlchemy 2 (async), structlog |
| Database | TimescaleDB (PostgreSQL 16 + asyncpg), Redis 7 |
| Exchange | Binance USDM Futures via CCXT 4 (dual: ccxt.pro WS + ccxt.async_support REST) |
| ML | XGBoost, GRU (PyTorch), ONNX Runtime |
| Auth | JWT (bcrypt), per-request token validation |
| Deploy | Docker Compose, Oracle Cloud Always Free (4 ARM, 24GB RAM) |
- Docker + Docker Compose
- Python 3.13+ with venv
- Node.js 20+
- Binance API keys (demo or live)
docker compose up -d timescaledb redis # TimescaleDB on port 5433, Redis on 6379cd backend
python -m venv .venv
.venv/Scripts/activate # Windows
# source .venv/bin/activate # Linux/Mac
pip install -r requirements.txt
# Configure .env with Binance keys
cp .env.example .env
# Edit .env: BINANCE_API_KEY, BINANCE_API_SECRET
# Start
python -m uvicorn app.main:app --port 8000cd frontend
npm install
# Configure API proxy
echo "API_URL=http://localhost:8000" > .env.local
echo "NEXT_PUBLIC_WS_URL=ws://localhost:8000/ws" >> .env.local
npm run devcd backend
python scripts/seed_data.pyOpen http://localhost:3000 and login with your credentials.
| Strategy | Weight | Description |
|---|---|---|
| Momentum | 0.15 | EMA crossovers + RSI + ADX trend strength |
| Mean Reversion | 0.10 | Bollinger Band + RSI oversold/overbought |
| Smart Money (SMC) | 0.25 | Order flow, liquidity sweeps, fair value gaps |
| Volume Analysis | 0.15 | OBV divergence + volume profile + VWAP |
| Funding Arbitrage | 0.05 | Funding rate extremes + open interest shifts |
| Order Block Zones | 0.20 | Supply/demand zones + structure breaks + MTF confirmation |
# Unit tests (1261+ tests, ~5 min)
cd backend
python run_tests.py all
# E2E tests (37 tests, Playwright)
cd frontend
npx playwright test
# Frontend build check
cd frontend
npx next build"Quant Obsidian" -- High-density editorial-grade trading terminal.
| Token | Value |
|---|---|
| Background | #0D0D0D |
| Surface | #131313 / #1C1B1B / #201F1F / #2A2A2A |
| Accent (Cyan) | #00F0FF |
| Profit (Green) | #40E56C |
| Loss (Red) | #FFB4AB |
| Text Primary | #E5E2E1 |
| Text Muted | #B9CACB |
| Font Headline | Inter |
| Font Mono | JetBrains Mono |
| Border Radius | rounded-sm (2-4px) only |
| Elevation | Tonal layering (no shadows) |
| Method | Path | Description |
|---|---|---|
| POST | /api/auth/login |
JWT authentication |
| POST | /api/auth/register |
Create account |
| PUT | /api/auth/change-password |
Change password |
| GET | /api/bot/status |
Bot status + balance |
| POST | /api/bot/start |
Start trading bot |
| POST | /api/bot/stop |
Stop trading bot |
| GET | /api/signals |
List signals (filtered) |
| GET | /api/signals/history |
Signal history |
| GET | /api/positions |
List positions (filter by status/mode) |
| GET | /api/positions/exchange |
Live Binance positions |
| POST | /api/positions/{id}/close |
Close position |
| PUT | /api/positions/{id}/sl |
Update stop loss |
| PUT | /api/positions/{id}/tp |
Update take profits |
| GET | /api/analytics/live-performance |
Real performance metrics from closed trades |
| GET | /api/candles |
OHLCV candle data (with end_time for lazy load) |
| GET | /api/indicators |
Technical indicators (16 types) |
| GET | /api/markets |
Available trading pairs (548+) |
| GET | /api/wallet/balances |
All wallet balances |
| POST | /api/wallet/transfer |
Internal transfer |
| POST | /api/orders/manual |
Manual order placement |
| POST | /api/backtest/run |
Run backtest simulation |
| GET | /api/backtest/{id} |
Get backtest results |
| GET | /api/backtest/verify/{id} |
Verify backtest integrity |
| GET | /api/backtest/history |
List all past backtests |
| GET | /api/settings |
Platform settings |
| PUT | /api/settings/risk |
Update risk params |
| GET/PUT | /api/settings/dca |
DCA configuration |
| GET/PUT | /api/settings/signal-policy |
Signal execution matrix |
| PUT | /api/settings/notifications |
Alert preferences |
| GET | /api/health/detailed |
System health check |
| WS | /ws |
Real-time updates (prices, signals, positions, bot status) |
Completed:
- 6 trading strategies with ML ensemble scoring
- Paper + Live trading with SL/TP/trailing stops
- Comprehensive backtesting with 10 interactive charts
- Strategy comparison page
- Real-time analytics from closed positions
- DCA / Average Down system
- Rate limiting, CORS, JWT auth hardening
- Notification system (WebSocket-driven)
- Chart infinite scroll + bottom trading panel
Planned:
- Advanced chart types (DOM Ladder, TPO, Heatmap)
- Multi-exchange support (Bybit, OKX)
- Strategy builder UI (visual drag-and-drop)
- Telegram/Discord push notifications
- Email verification + Google OAuth
- Multi-user with role-based access
- CI/CD deployment pipeline
- Mobile-responsive improvements
This project is open source and contributions are very welcome! Whether it's a new strategy idea, a bug fix, UI improvement, or a completely new feature — feel free to open an issue or submit a PR.
The goal is simple: build a solid open-source trading toolkit together. Who knows, maybe with enough brains collaborating we can actually beat the market. Let's find out.
How to contribute:
- Fork the repo
- Create a feature branch (
git checkout -b feat/your-idea) - Make your changes
- Open a Pull Request
No contribution is too small. Even typo fixes and documentation improvements help.