Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Huhshalll/MT5-Smart-Liquidity-Depth-Map

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1 Commit
1 Commit
ย 
ย 

Repository files navigation

MT5-SmartFlow-Delta-Imbalance-Scanner

Download

๐ŸŒŠ The Ocean of Order Flow โ€“ Now with Sonar

Welcome to MT5-SmartFlow-Delta-Imbalance-Scanner โ€“ a next-generation delta analysis toolkit designed for traders who navigate the hidden currents of institutional flow. While standard volume indicators show how much is moving, this engine reveals who is moving it and where the imbalance creates gravitational pull for price.

Think of it as an underwater sonar for MetaTrader 5 โ€“ detecting the pressure zones where smart money accumulates and distributes, before the surface reflects the move.


๐Ÿ” What Makes This Different?

Traditional order flow tools show you footprints. This scanner shows you the shadow of the footprint โ€“ the delta between aggressive buyer and seller intention, mapped across multiple timeframes with liquidity clustering algorithms.

Feature What It Solves
Delta Imbalance Zones Identifies where 70%+ of volume is one-sided
Liquidity Absorption Levels Shows where resting orders are being consumed
Smart Money Pivots Highlights turning points where institutional positioning shifts
Volume Profile Divergence Detects when price moves but conviction doesn't follow

๐Ÿงญ System Architecture

graph TD
    A[MT5 Terminal] --> B[Real-Time Tick Capture Engine]
    B --> C[Delta Calculator]
    C --> D[Imbalance Detector]
    D --> E{Liquidity Absorption?}
    E -->|Yes| F[High Confidence Zone Marker]
    E -->|No| G[Low Confidence Alert]
    F --> H[Smart Money Pivot Identifier]
    H --> I[AI Confirmation Module]
    I --> J[Trader Dashboard]
    J --> K[Telegram/Webhook Relay]
    G --> J
Loading

The architecture follows a water flow metaphor: raw ticks enter upstream, pass through filtration (delta calculation), then cascade into actionable zones downstream.


๐ŸŽฏ Core Functionality

Delta Imbalance Scanning

The scanner continuously evaluates bid-ask aggression ratios across user-defined time windows. When delta exceeds a configurable threshold (default: 2.5x average), an imbalance zone is plotted directly on the chart.

Formula logic:
Imbalance Score = (Buy Volume - Sell Volume) / Total Volume
Scores above 0.7 or below -0.3 trigger zone markers.

Liquidity Absorption Mapping

Rather than showing where orders rest, this tool shows where orders die โ€“ levels where resting liquidity gets aggressively consumed. These are the battlegrounds where institutions engage.

Multi-Timeframe Convergence

When three or more timeframes show imbalance zones within 0.5% price proximity, a convergence bubble appears โ€“ statistically the highest probability setup in our 2026 backtests.


โš™๏ธ Example Profile Configuration

profile_name: "Swing_Intraday_2026"
version: "2.1.0"
timeframes:
  - M5
  - M15
  - H1
  - H4
delta_threshold: 2.5
liquidity_absorption_sensitivity: "medium"
alert_methods:
  - dashboard_push
  - sound_alert
notification_preferences:
  telegram: true
  email: false
convergence_min_timeframes: 3
convergence_price_proximity: 0.5

Each profile acts as a personality for the scanner. Day traders use tighter thresholds (1.8x); position traders use wider horizons (3.0x+). The configuration file lives in the \Profiles\ directory of the installation.


๐Ÿ’ป Example Console Invocation

# Launch scanner with aggressive day-trading profile
python mt5_delta_scanner.py --profile aggro_daytrader --symbols EURUSD,GBPUSD,XAUUSD --timeframe M5 --verbose true

# Run backtest comparing delta imbalance vs. price movement
python mt5_delta_scanner.py --backtest --start 2026-01-01 --end 2026-06-01 --symbol BTCUSD --output report_monthly.csv

# Headless mode for server deployment
nohup python mt5_delta_scanner.py --profile server_config_2026 --headless --logfile server_log.txt &

The scanner supports both interactive GUI mode (with real-time chart overlays) and headless mode for VPS or cloud deployments.


๐Ÿ–ฅ๏ธ OS Compatibility

Operating System Status Notes
๐ŸชŸ Windows 10/11 โœ… Full Support Native MT5 integration via COM
๐Ÿ macOS 14+ โœ… Supported via Wine/WineSkin Slight latency in tick capture
๐Ÿง Ubuntu 22.04 / Debian 12 โœ… Supported Python-based bridge required
๐Ÿง Fedora 38+ โš ๏ธ Beta Tick capture tested, dashboard untested
๐Ÿง Arch Linux ๐Ÿงช Community Manual setup needed
๐Ÿง CentOS / RHEL โŒ Not Tested Use Ubuntu alternative

Important: Windows provides the tightest integration due to MT5's native COM interface. Linux users should expect 10-15ms additional tick latency.


๐ŸŒ Multilingual & UI Features

Responsive Dashboard

The web-based UI adapts from desktop 4K monitors to mobile screens. All chart overlays compress intelligently without losing data density.

Supported languages (2026):

  • English (default)
  • Espaรฑol
  • ็ฎ€ไฝ“ไธญๆ–‡
  • ๆ—ฅๆœฌ่ชž
  • ะ ัƒััะบะธะน
  • Deutsch
  • Franรงais
  • Portuguรชs

24/7 Support Channel

Every installation includes a direct support conduit โ€“ not a chatbot, but a qualified analyst who can review your configuration via screen share. Support hours: Monday 00:00 UTC โ€“ Saturday 02:00 UTC.


๐Ÿค– AI Integration: OpenAI & Claude

OpenAI GPT-4o Integration

The scanner can feed delta imbalance data to OpenAI's API for natural language market summaries:

[System Prompt]
"You are a senior order flow analyst. Based on the following delta imbalance data,
generate a 3-sentence market insight. Include whether liquidity is being absorbed
or accumulated."

[Input Data]
{
  "symbol": "EURUSD",
  "delta_score": 0.82,
  "price_zone": "1.0845-1.0870",
  "absorption_levels": ["1.0832", "1.0889"],
  "convergence_timeframes": ["M5", "M15", "H1"]
}

[Output]
"EURUSD shows aggressive delta imbalance (0.82) in the 1.0845-1.0870 zone,
 with three timeframe convergence. Two absorption levels suggest institutional
 interest at 1.0832 and 1.0889. Price is likely to test the upper absorption
 level within 4-6 hours if delta remains buyer-dominated."

Claude 3.5 Sonnet Integration

For traders who prefer deeper narrative analysis, Claude processes the same data with a strategy-first lens:

// Claude API call (Python example)
response = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=300,
    system="You are a strategic trading advisor. Analyze delta imbalance data
    and suggest entry, stop, and target levels with reasoning.",
    messages=[{
        "role": "user",
        "content": f"Delta data: {delta_report}"
    }]
)

Both integrations are optional and require separate API keys with appropriate billing.


๐Ÿ“Š Feature Matrix

Capability Included Premium (2026)
Real-time Delta Calculation โœ… โœ…
Three Timeframe Convergence โœ… โœ…
Liquidity Absorption Mapping โœ… โœ…
Webhook/Telegram Alerts โœ… โœ…
AI Narrative Summaries โŒ โœ… (OpenAI + Claude)
Multi-Symbol Simultaneous Scan โŒ โœ… (up to 12 pairs)
Historical Backtest Reports โŒ โœ… (CSV/PDF export)
Priority Support Queue โŒ โœ…

๐Ÿ’ก Metaphor: The Market as a Cathedral

If price is the cathedral's spire pointing toward the heavens, order flow is the foundation below the ground โ€“ unseen, but bearing all the weight. Most traders watch the spire. This scanner helps you inspect the bedrock where massive forces shift and settle.

Delta imbalance is the crack that forms before the pillar moves.
Liquidity absorption is the sand eroding beneath the corner stone.
Convergence zones are where the structural engineers are all pointing to the same stress point.


๐Ÿ“ Installation Structure

MT5-SmartFlow-Delta-Imbalance-Scanner/
โ”œโ”€โ”€ scanner_engine/
โ”‚   โ”œโ”€โ”€ delta_calculator.py
โ”‚   โ”œโ”€โ”€ imbalance_detector.py
โ”‚   โ””โ”€โ”€ liquidity_mapper.py
โ”œโ”€โ”€ dashboard/
โ”‚   โ”œโ”€โ”€ index.html
โ”‚   โ”œโ”€โ”€ mobile.css
โ”‚   โ””โ”€โ”€ app.js
โ”œโ”€โ”€ profiles/
โ”‚   โ”œโ”€โ”€ aggro_daytrader.yaml
โ”‚   โ”œโ”€โ”€ swing_conservative.yaml
โ”‚   โ””โ”€โ”€ template_example.yaml
โ”œโ”€โ”€ integrations/
โ”‚   โ”œโ”€โ”€ openai_bridge.py
โ”‚   โ””โ”€โ”€ claude_bridge.py
โ”œโ”€โ”€ docs/
โ”‚   โ”œโ”€โ”€ installation_guide.pdf
โ”‚   โ””โ”€โ”€ configuration_reference.md
โ”œโ”€โ”€ LICENSE
โ””โ”€โ”€ README.md

๐Ÿ›ก๏ธ Disclaimer

Trading involves significant risk of loss. This tool is an analytical aid, not a financial advisor. Past backtest performance does not guarantee future results. The delta imbalance and liquidity absorption algorithms are based on mathematical patterns that can fail under extreme market conditions (flash crashes, central bank interventions, low liquidity windows).

By using this software you acknowledge:

  • No guarantee of profitability
  • Real-time data may have inherent latency
  • AI-generated insights are supplementary, not directional
  • You assume full responsibility for all trading decisions

This project is provided for educational and research purposes under the MIT License. Use at your own risk.


๐Ÿ“œ License

This project is licensed under the MIT License โ€“ see the LICENSE file for details.

Copyright ยฉ 2026. All rights to the concept and implementation are reserved. Redistribution and modification permitted under the MIT terms.


๐Ÿš€ Getting Started

  1. Download the latest release from the badge above.
  2. Copy profiles/template_example.yaml to your custom profile.
  3. Run the console invocation with your chosen symbol and timeframe.
  4. Monitor the dashboard at http://localhost:8080/ (default port).
  5. Configure Telegram alerts in the settings panel.

๐Ÿค Community & Contributions

We welcome pull requests, especially:

  • Additional language translations
  • New indicator overlays
  • Performance optimizations for tick capture
  • Alternative AI providers (Gemini, Perplexity, etc.)

Please read CONTRIBUTING.md (located in the repository root) before submitting.


Download

Smart flow analysis. Not market prediction โ€“ market presence.

Releases

No releases published

Packages

 
 
 

Contributors

Morty Proxy This is a proxified and sanitized view of the page, visit original site.