rufinomec-afk
54f269b0ce
- Bottom panel: dual bid/ask bars per cluster (red=sell, blue=buy) with white volume label inside and delta block below - Price axis: labels every 10 rows (~7.5pts) instead of every row — cleaner, closer to original - Price axis: bid/ask spread boxes with arrow indicator (shows on live market open) - Price axis zoom: inverted so drag-up = zoom in, matching original behavior - Current price line rendered last (always on top of all bars) - Bar colors: corrected — ask (buy) = blue, bid (sell) = pink - Backend: close_time field added to cluster JSON; bar_volume M1 annotation (triggers after replay) - Backend: last_bid/ask tracked and injected into active cluster WS message Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
YuClusters Local 📊
YuClusters Local is a professional footprint chart and volumetric cluster analyzer integrated directly with your local MetaTrader 5 (MT5) terminal.
Key Features
- Real-Time Footprint Charting: Ticks polled at ~100ms intervals and visualised dynamically using an optimized HTML5 Canvas element.
- Diagonal Imbalances Detection: Identifies aggressive buying or selling imbalances (
R \ge 3.0). - Stacked Imbalances Highlights: Dynamically spots 3+ consecutive imbalances in the same direction.
- POC Highlight: Identifies and highlights the highest volume nodes within each cluster using a gold border.
- Interactive Drag & Pan UI: Fully-featured HTML5 Canvas dashboard with drag-to-scroll horizontal/vertical panning and zoom adjustment.
Installation & Setup
1. Prerequisites
- Windows OS (required by MetaTrader 5 API)
- MetaTrader 5 Terminal running locally and logged into your broker account
- Python 3.11+ installed and added to PATH
- Node.js 18+ installed
2. Backend Installation
- From the project root, install Python dependencies:
pip install -r requirements.txt - Set your environment configurations in
config/settings.pyor export them as environment variables (e.g.MT5_LOGIN,MT5_PASSWORD,MT5_SERVER).
3. Frontend Installation
- Navigate to the
frontend/folder:cd frontend - Install npm packages:
npm install
Execution Guide
1. Run the Backend Server
Start the FastAPI server (this will automatically launch the MetaTrader 5 polling collector):
python backend/server.py
2. Run the React Frontend
Start the Vite development server:
cd frontend
npm run dev
Open http://localhost:3000 in your web browser.
Technical Calculations (from SKILL.md)
- Diagonal Buy Imbalance:
ask_vol[i] >= R * bid_vol[i-1](compares with price level below) - Diagonal Sell Imbalance:
bid_vol[i] >= R * ask_vol[i+1](compares with price level above) - POC (Point of Control): Price level with the highest total volume (
ask_vol + bid_vol) inside a cluster. If volumes tie, the highest price wins. - Stacked Imbalance Zone: A vertical zone spanning 3 or more consecutive levels with the same imbalance direction.