kbDeviationFrom

Cryptocurrency RSI Divergence Signal Monitor Real-time visualization based on 6-condition triple divergence detection.

中文文档

Screenshots

Left: Quadrant Chart | Right: K-line Chart with Divergence Markers

Features

• Quadrant Visualization - RSI (X-axis) vs Signal Score (Y-axis) scatter plot
• 6-Condition Triple Divergence Detection - Price pattern + RSI pattern + MACD momentum + Zero-line crossover + Extremes + Dow structure
• Weighted Scoring System - RSI 40% + Divergence Strength 40% + MACD 20%
• Real-time K-line Charts - Integrated RSI/MACD indicators and divergence markers
• Zone Classification - GOLDEN_LONG, GOLDEN_SHORT, WATCH_LONG, WATCH_SHORT, NEUTRAL

Quick Start

Prerequisites

• Node.js 18+
• Go 1.21+
• Python 3.10+

Installation

# Clone repository
git clone https://github.com/yourusername/kbDeviationFrom.git
cd kbDeviationFrom

# Install frontend dependencies
cd frontend && npm install

# Install Go dependencies
cd ../backend/go && go mod download

# Install Python dependencies
cd ../python
python -m venv venv
source venv/bin/activate  # Linux/macOS
pip install -r requirements.txt

Development

# Terminal 1: Backend
cd backend/go && go run cmd/server/main.go

# Terminal 2: Frontend
cd frontend && npm run dev

Visit http://localhost:5173

Production Build

# Frontend
cd frontend && npm run build

# Backend
cd backend/go && go build -o server cmd/server/main.go

Tech Stack

Layer	Technologies
Frontend	React 18, TypeScript, Vite, Tailwind CSS
Charts	ECharts (Quadrant), Lightweight Charts (K-line)
State	Zustand
Backend	Go, Gin, SQLite
Algorithm	Python, NumPy
Real-time	WebSocket

Algorithm

6-Condition Triple Divergence Detection

Condition	Description
C1	Price Pattern: P1 > P2 > P3 (triple tops) or P1 < P2 < P3 (triple bottoms)
C2	RSI Pattern: RSI1 < RSI2 < RSI3 (bearish) or RSI1 > RSI2 > RSI3 (bullish)
C3	Momentum Convergence: MACD histogram area decreasing
C4	Zero-line Crossover: MACD line crosses zero
C5	Extremes: RSI < 30 (oversold) or RSI > 70 (overbought)
C6	Dow Structure: High/low structure confirmation

Zone Classification

Zone	RSI Range	Score Range	Signal
GOLDEN_LONG	< 30	> 80	Strong long
GOLDEN_SHORT	> 70	< -80	Strong short
WATCH_LONG	30-50	> 60	Watch for long
WATCH_SHORT	50-70	< -60	Watch for short
NEUTRAL	-	-	Neutral

API Endpoints

Endpoint	Method	Description
/api/v1/quadrant	GET	Get quadrant chart data
/api/v1/kline/:symbol	GET	Get K-line data
/api/v1/signals	GET	Get signal list
/ws	WS	WebSocket real-time updates

Configuration

# Environment variables
PORT=9090
DATABASE_PATH=./data/kbdeviation.db

# Binance API (optional)
BINANCE_API_KEY=your_api_key
BINANCE_API_SECRET=your_api_secret

# CORS
ALLOWED_ORIGINS=http://localhost:3000,http://localhost:5173

Testing

# Frontend
cd frontend && npm test

# Backend (Go)
cd backend/go && go test ./...

# Backend (Python)
cd backend/python && source venv/bin/activate && pytest --cov=algorithms

License

MIT

Disclaimer

This project is for educational and research purposes only. It does not constitute investment advice. Cryptocurrency trading carries high risk - trade responsibly.