How jpxproject/jev-mt5-hft-framework works
JEV-MT5 Sentinel combines a MetaTrader 5 trading runtime with a local Python decision bridge. The principal flow runs from market ticks through state and pricing, applies hard risk vetoes, and executes trades; the bridge supplies AI or local-rule judgments and composes actions. Separate capabilities include a web dashboard, native chart HUD, and an autonomous MT5 co-pilot. MQL module interactions are represented from the README topology; unsampled implementation details are not inferred.
Main entry points: bridge_server.py FastAPI Bridge · JevState.mqh Market State · JevRiskEngine.mqh Risk Veto Engine · gemini_client.py Market Evaluation
Components 18
MT5 Trading Runtime
- Trading Expert
mql5/Experts/JevLoop_HFT_EA.mq5 - Market State
mql5/Include/JevState.mqh - Reservation Pricing
mql5/Include/JevPricing.mqh - Risk Veto Engine
mql5/Include/JevRiskEngine.mqh - MQL Fallback
mql5/Include/JevFallback.mqh - Order Execution
mql5/Experts/JevLoop_HFT_EA.mq5
Decision Bridge
- FastAPI Bridge
bridge/bridge_server.py - Market Evaluation
bridge/gemini_client.py - Local Rules Evaluator
bridge/gemini_client.py - Action Composer
bridge/strategy.py
Monitoring Interfaces
- Web Dashboard
bridge/static/index.html - Chart HUD
mql5/Indicators/JevSentinel_HUD.mq5 - Bridge Watchdog
bridge/watchdog_247.py
Autonomous Co-pilot
- Co-pilot Daemon
bridge/copilot_trader_daemon.py - Co-pilot Trade Events
bridge/copilot_ledger.jsonl
Other components
- Market Ticks
- Gemini API
- MT5 Broker
Connections 18
- Market Ticks → Trading Expert: triggers
README.md - Trading Expert → Market State: updates state
README.md - Market State → FastAPI Bridge: sends snapshot
README.md - FastAPI Bridge → Market Evaluation: requests evaluation
bridge/bridge_server.py - Market Evaluation → Gemini API: queries
- Market Evaluation → Local Rules Evaluator: falls back
bridge/gemini_client.py - FastAPI Bridge → Action Composer: composes action
bridge/bridge_server.py - Action Composer → FastAPI Bridge: returns action
README.md - FastAPI Bridge → Reservation Pricing: sends signal
README.md - Reservation Pricing → Risk Veto Engine: prices orders
README.md - Risk Veto Engine → Order Execution: permits trades
README.md - Order Execution → MT5 Broker: places orders
README.md - Risk Veto Engine → Market State: veto freezes
README.md - Market State → Chart HUD: feeds display
README.md - FastAPI Bridge → Web Dashboard: serves dashboard
bridge/bridge_server.py - Bridge Watchdog → FastAPI Bridge: restarts if unhealthy
bridge/watchdog_247.py - Co-pilot Daemon → MT5 Broker: executes trades
bridge/copilot_trader_daemon.py - Co-pilot Daemon → Co-pilot Trade Events: records events