main
Porta fiel do YuClusters em MQL5 puro via CCanvas, sem dependências externas. Funcionalidades: - Clusters bid/ask por nível com POC, modo delta, painel inferior - Ferramentas de desenho: Zona e Volume Profile de região (right-drag) - Painéis de configuração via right-click com color picker inline (160 cores) - Zoom vertical/horizontal, pan, eixo de preço customizado - Menu de configurações (formação + cores) com gear button
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.
Description
Languages
MQL5
39.8%
JavaScript
30.9%
Python
27.3%
Shell
0.9%
HTML
0.5%
Other
0.6%