Upload 68 files

.gitattributes

@@ -33,3 +33,34 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+2026-01-20[[:space:]]20-32-35.mp4 filter=lfs diff=lfs merge=lfs -text
+2026-01-21[[:space:]]10-45-20.mp4 filter=lfs diff=lfs merge=lfs -text
+2026-01-21[[:space:]]14-03-26.mp4 filter=lfs diff=lfs merge=lfs -text
+2026-01-22[[:space:]]08-42-06.mp4 filter=lfs diff=lfs merge=lfs -text
+2026-01-22[[:space:]]10-09-23.mp4 filter=lfs diff=lfs merge=lfs -text
+funny[[:space:]]replies/funny3.png filter=lfs diff=lfs merge=lfs -text
+Install[[:space:]]VisualStudio[[:space:]]C++[[:space:]]Build[[:space:]]Tools.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv1.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv2.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv3.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv4.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv5.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv6.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv7.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv8.png filter=lfs diff=lfs merge=lfs -text
+search/arxiv/arxiv9.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly2.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly3.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly4.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly5.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly6.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly7.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly8.png filter=lfs diff=lfs merge=lfs -text
+search/baiduscholarly/baiduscholarly9.png filter=lfs diff=lfs merge=lfs -text
+search/ssrn/ssrn3.png filter=lfs diff=lfs merge=lfs -text
+search/ssrn/ssrn4.png filter=lfs diff=lfs merge=lfs -text
+search/ssrn/ssrn5.png filter=lfs diff=lfs merge=lfs -text
+survey/ans1.png filter=lfs diff=lfs merge=lfs -text
+survey/ans5.png filter=lfs diff=lfs merge=lfs -text
+survey/ans6.png filter=lfs diff=lfs merge=lfs -text
+survey/grok's[[:space:]]validation[[:space:]]to[[:space:]]my[[:space:]]proof-of-work.png filter=lfs diff=lfs merge=lfs -text

2026-01-20 20-32-35.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:051d78448902b28a2dc924c0e39d97b9e9cc824725199534ed0b469120639407
+size 1805330

2026-01-21 10-45-20.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:593723d5b2e5c2ec2d89c8e2e42b286a0da940e93314109ec23bbc1c2bfb2337
+size 3690040

2026-01-21 14-03-26.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8aee69e82d76a2e3c606030fd402d7ec46c815de6cdb4557ca6727caca1aa99e
+size 1761437

2026-01-22 08-42-06.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:655c73933a338d1637fd6c37238da565df3267771c2673081890d0e17e7faf48
+size 13171932

2026-01-22 10-09-23.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:67735df868c427e75eaf564b544fbc69c589ce38f094efe3d1fe3a56ba44abe7
+size 3233734

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rembrant Oyangoren Albeos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

MQL5/Experts/ZmqPublisher.mq5

@@ -0,0 +1,77 @@
+//+------------------------------------------------------------------+
+//|                                                 ZmqPublisher.mq5 |
+//|                                    Copyright 2024, Antigravity   |
+//|                                                                  |
+//+------------------------------------------------------------------+
+#property copyright "Antigravity"
+#property link      ""
+#property version   "1.00"
+
+// Include our ZMQ wrapper
+#include <Zmq/Zmq.mqh>
+
+// Input parameters
+input string InpBindAddress = "tcp://0.0.0.0:5555"; // Bind Address
+
+CZmq *g_publisher;
+
+//+------------------------------------------------------------------+
+//| Expert initialization function                                   |
+//+------------------------------------------------------------------+
+int OnInit()
+  {
+   Print("Initializing ZmqPublisher...");
+   
+   g_publisher = new CZmq();
+   
+   if(!g_publisher.Init(ZMQ_PUB)) {
+      Print("Failed to initialize ZMQ Publisher");
+      return(INIT_FAILED);
+   }
+   
+   if(!g_publisher.Bind(InpBindAddress)) {
+      Print("Failed to bind to ", InpBindAddress);
+      return(INIT_FAILED);
+   }
+   
+   Print("ZmqPublisher bound to ", InpBindAddress);
+   return(INIT_SUCCEEDED);
+  }
+
+//+------------------------------------------------------------------+
+//| Expert deinitialization function                                 |
+//+------------------------------------------------------------------+
+void OnDeinit(const int reason)
+  {
+   Print("Deinitializing ZmqPublisher...");
+   if(g_publisher != NULL) {
+      g_publisher.Shutdown();
+      delete g_publisher;
+      g_publisher = NULL;
+   }
+  }
+
+//+------------------------------------------------------------------+
+//| Expert tick function                                             |
+//+------------------------------------------------------------------+
+void OnTick()
+  {
+   if(g_publisher == NULL) return;
+   
+   MqlTick tick;
+   if(SymbolInfoTick(_Symbol, tick)) {
+      // Create JSON string manually to avoid complex dependencies
+      // Format: {"symbol": "XAUUSD", "bid": 2000.5, "ask": 2000.8, "time": 123456789}
+      
+      string json;
+      StringConcatenate(json, "{\"symbol\":\"", _Symbol, 
+                        "\",\"bid\":", DoubleToString(tick.bid, _Digits),
+                        ",\"ask\":", DoubleToString(tick.ask, _Digits),
+                        ",\"time\":", IntegerToString(tick.time),
+                        "}");
+                        
+      g_publisher.Send(json);
+      // Print("Published: ", json); // Uncomment for debugging (spammy)
+   }
+  }
+//+------------------------------------------------------------------+

MQL5/Include/Zmq/Zmq.mqh

@@ -0,0 +1,112 @@
+//+------------------------------------------------------------------+
+//|                                                          Zmq.mqh |
+//|                                    Copyright 2024, Antigravity   |
+//|                                                                  |
+//+------------------------------------------------------------------+
+#property copyright "Antigravity"
+#property link      ""
+#property strict
+
+// Define ZMQ constants
+#define ZMQ_PUB 1
+#define ZMQ_SUB 2
+#define ZMQ_REQ 3
+#define ZMQ_REP 4
+
+#define ZMQ_NOBLOCK 1
+
+// Import functions from libzmq.dll
+// NOTE: Make sure libzmq.dll is in your MQL5/Libraries folder
+// Handles are void* (64-bit on x64), so using 'long' works for both 32 (too big but safe) and 64 bit
+#import "libzmq.dll"
+   long zmq_ctx_new();
+   int zmq_ctx_term(long context);
+   long zmq_socket(long context, int type);
+   int zmq_close(long socket);
+   int zmq_bind(long socket, uchar &endpoint[]);
+   int zmq_connect(long socket, uchar &endpoint[]);
+   int zmq_send(long socket, uchar &buf[], int len, int flags);
+   int zmq_recv(long socket, uchar &buf[], int len, int flags);
+   int zmq_errno();
+#import
+
+class CZmq {
+private:
+   long m_context;
+   long m_socket;
+   bool m_initialized;
+
+public:
+   CZmq() {
+      m_context = 0;
+      m_socket = 0;
+      m_initialized = false;
+   }
+
+   ~CZmq() {
+      Shutdown();
+   }
+
+   bool Init(int type) {
+      if(m_initialized) return true;
+      
+      m_context = zmq_ctx_new();
+      if(m_context == 0) {
+         Print("ZMQ Init failed: Context creation error");
+         return false;
+      }
+      
+      m_socket = zmq_socket(m_context, type);
+      if(m_socket == 0) {
+         Print("ZMQ Init failed: Socket creation error");
+         return false;
+      }
+      
+      m_initialized = true;
+      return true;
+   }
+
+   bool Bind(string endpoint) {
+      if(!m_initialized) return false;
+      
+      uchar data[];
+      StringToCharArray(endpoint, data, 0, WHOLE_ARRAY, CP_UTF8);
+      
+      int rc = zmq_bind(m_socket, data);
+      if(rc != 0) {
+         Print("ZMQ Bind failed. Error: ", zmq_errno());
+         return false;
+      }
+      return true;
+   }
+
+   int Send(string message, bool nonBlocking = true) {
+      if(!m_initialized) return -1;
+      
+      uchar data[];
+      StringToCharArray(message, data, 0, WHOLE_ARRAY, CP_UTF8);
+      // StringToCharArray includes null terminator, we might not want to send it
+      // ZMQ messages are just bytes.
+      // -1 because array size includes null char, usually we check ArraySize(data)
+      int len = ArraySize(data) - 1; 
+      if (len < 0) len = 0;
+
+      int flags = 0;
+      if(nonBlocking) flags = ZMQ_NOBLOCK;
+      
+      int bytesSent = zmq_send(m_socket, data, len, flags);
+      return bytesSent;
+   }
+
+   void Shutdown() {
+      if(m_socket != 0) {
+         zmq_close(m_socket);
+         m_socket = 0;
+      }
+      if(m_context != 0) {
+         zmq_ctx_term(m_context);
+         m_context = 0;
+      }
+      m_initialized = false;
+   }
+};

README.md

@@ -0,0 +1,324 @@
+## Rust + ZMQ + MT5's MQL5: Exploiting Micro-Second BID/ASK Live Trading Data
+
+The system operates on a publisher-subscriber model using ZeroMQ (ZMQ) to bridge MetaTrader 5 (via MQL5) and the external Rust application. To exploit micro-second BID/ASK live trading data to create a simple orderflow charting tool.
+
+![Rust](https://img.shields.io/badge/Rust-000000?style=for-the-badge&logo=rust&logoColor=white)
+![MetaTrader 5](https://img.shields.io/badge/MetaTrader_5-0075FF?style=for-the-badge&logo=metatraderfive&logoColor=white)
+![ZeroMQ](https://img.shields.io/badge/ZeroMQ-DF0000?style=for-the-badge&logo=zeromq&logoColor=white)
+![MQL5](https://img.shields.io/badge/MQL5-F5A623?style=for-the-badge&logo=metatraderfive&logoColor=white)
+![License](https://img.shields.io/badge/License-MIT-green?style=for-the-badge)
+
+## Software Demonstration
+
+https://github.com/user-attachments/assets/71c51bb2-324b-4c97-ab0d-807a2c0d0d7c
+
+### Mechanics
+1.  **Publisher (MQL5)**:
+    -   The `ZmqPublisher.mq5` Expert Advisor initializes a ZMQ **PUB** socket and binds it to `tcp://*:5555`.
+    -   On every market tick (`OnTick()`), it retrieves the current Bid/Ask prices.
+    -   It constructs a JSON object (e.g., `{"symbol": "XAUUSD", "bid": 2025.50, ...}`) and publishes it as a message.
+
+2.  **Subscriber (Rust)**:
+    -   The `mt5-chart` application initializes a ZMQ **SUB** socket and connects to `tcp://127.0.0.1:5555`.
+    -   It runs an asynchronous Tokio task that listens for incoming ZMQ messages.
+    -   Upon receiving a message, it deserializes the JSON data into a Rust struct (`TickData`).
+    -   The data is sent via an internal channel (`mpsc`) to the GUI thread.
+    -   The `eframe`/`egui` interface updates the chart and labels in real-time.
+
+### Workflow Algorithm
+
+```mermaid
+sequenceDiagram
+    participant MT5 as MetaTrader 5 (MQL5)
+    participant ZMQ as ZeroMQ (PUB/SUB)
+    participant Rust as Rust Client (mt5-chart)
+    participant GUI as GUI (egui)
+
+    Note over MT5, Rust: Initialization
+    Rust->>ZMQ: Connect (SUB) to tcp://127.0.0.1:5555
+    MT5->>ZMQ: Bind (PUB) to tcp://0.0.0.0:5555
+    
+    Note over MT5, GUI: Real-time Tick Loop
+    loop Every Tick
+        MT5->>MT5: Get SymbolInfoTick
+        MT5->>ZMQ: Publish JSON {"symbol":..., "bid":...}
+        ZMQ->>Rust: Receive Message
+        Rust->>Rust: Parse JSON to TickData
+        Rust->>GUI: Send Data via Channel
+        GUI->>GUI: Update Plot & Request Repaint
+    end
+```
+
+
+---
+
+## Trivia
+
+[<img width="911" height="214" alt="image" src="https://github.com/user-attachments/assets/67fb1c13-53db-4056-b022-e8a64db493e4" />](https://x.com/qsrsunstoic/status/2014165161381363739)
+> **The very First**: Exploiting micro-second BID/ASK live trading data from **MetaTrader 5 (MT5)** using the specific combination of **Rust + ZeroMQ (ZMQ) + MetaQuotes Language (MQL5)**.
+
+I was trying to make a trading orderflows platform, and I came up with an idea: why not use MT5 as datafeed for it? Unfortunately, there are no existing ideal projects I could use as a benchmark, hence I created my own. <br><br>
+I've  worked on and made ~100+ Python trading projects, and I always use MT5 as datafeed, but I want faster; that is why I came up with using Rust as a solution, and ZMQ binding for MT5 is a common practice. In worse case sscenario, there are no _Rust + ZMQ + MT5_ combination projects existed in the world, which is pretty nuts. I didn't know it only existed in my head, Lmao. So I created it with the help of Google Antigravity.
+
+This simple orderflow tool will serve as a benchmark for future projects.
+
+## A survey for AI leading platforms
+
+Extensive research across GitHub, Hugging Face, and consultation with 9 leading AI models confirmed that no prior public projects utilizing this exact high-performance stack existed before this implementation.
+
+**AI Survey Results**
+> "no public projects combination of Rust, ZeroMQ (ZMQ), and MetaTrader 5 (MT5)."
+
+**Proof**
+
+
+<table align="center">
+  <tr>
+    <td align="center">
+      <video 
+        src="https://github.com/user-attachments/assets/18f9865c-39b8-40cd-a969-733c435621db" 
+        controls 
+        muted
+        loop
+      ></video>
+    </td>
+    <td align="center">
+      <video 
+        src="https://github.com/user-attachments/assets/ccff1713-6c14-46cc-94b0-a1831f4a8b0d" 
+        controls 
+        muted
+        loop
+      ></video>
+    </td>
+  </tr>
+  <tr>
+    <td align="center">
+      <video 
+        src="https://github.com/user-attachments/assets/e9631b52-e548-4224-8684-72aa282c70f0" 
+        controls 
+        muted
+        loop
+      ></video>
+    </td>
+    <td align="center">
+      <video 
+        src="https://github.com/user-attachments/assets/fe251361-1103-4c6b-b198-88134820a074" 
+        controls 
+        muted
+        loop
+      ></video>
+    </td>
+  </tr>
+</table>
+
+
+
+**Additional Validation**:
+<table cellspacing="0" cellpadding="0">
+  <tr>
+    <td><img src="survey/ans1.png" alt=""></td>
+    <td><img src="survey/ans2.png" alt=""></td>
+    <td><img src="survey/ans3.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="survey/ans4.png" alt=""></td>
+    <td><img src="survey/ans5.png" alt=""></td>
+    <td><img src="survey/ans6.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="survey/ans7.png" alt=""></td>
+    <td><img src="survey/ans8.png" alt=""></td>
+    <td><img src="survey/ans9.png" alt=""></td>
+  </tr>
+</table>
+
+
+I used leading AI platforms (Grok, Gemini, Claude, ChatGPT, MSCopilot, Perplexity, Baidu (Ernie Bot), DeepSeek, Qwen) to validate my claim for _"**The very First**: Exploiting micro-second BID/ASK live trading data from **MetaTrader 5 (MT5)** using the specific combination of **Rust + ZeroMQ (ZMQ) + MetaQuotes Language (MQL5).**"_  
+
+In addition, I ran nine different search combinations on each of four scholarly platforms: Arxiv, Google Scholar, SSRN, and Baidu Scholar. The detailed results are documented in [*scholar.md*](search/scholar.md).
+
+*Visit my previous app to explore 284 AI platforms in one place, [AiQG](https://aiqg.vercel.app/)*  
+<br>
+
+During this process, some AI models produced hallucinated results. They suggested projects that only used partial pairs, such as Python with ZMQ or C++ with ZMQ, but never the full combination of all three components that I specified, namely Rust + ZMQ + MT5.
+
+To correct this, I provided an explicit follow-up instruction stating ***"strictly those 3 combination"***. I then repeated the same query: ***"Show me GitHub or Hugging projects or any link that has 'Rust + ZMQ + MT5 combination' (strictly those 3), never miss a single link"***.
+
+MetaTrader 5 uses MQL5 as its native language, which is built on C++. My objective was to extract live trading data from MT5 via ZMQ and process and visualize it in Rust to enable fast development of a high performance charting tool. After this clarification and repeated querying, all platforms returned the same conclusion.
+
+
+> "no public projects combination of Rust, ZeroMQ (ZMQ), and MetaTrader 5 (MT5)."
+
+Since no one did that combination, at least at the time of developing/writing *(Jan 20-21, 2026)*, I've decided to create one.
+
+---
+
+## Project Structure
+These are the only necessary files that you need to have.
+
+```graphql
+Rust-ZMQ-MQL5
+├── MQL5                        # Relocate this (individual files) into MT5's literal path directory, located outside this repository
+│   ├── Experts
+│   │   └── ZmqPublisher.mq5    # The "Server": Publishes Tick Data via TCP
+│   ├── Include
+│   │   └── Zmq
+│   │       └── Zmq.mqh         # ZMQ Wrapper Library for MQL5 (64-bit compatible)
+│   └── Libraries
+│       ├── libzmq.dll          # 64-bit ZeroMQ DLL (Required)
+│       └── libsodium.dll       # Dependency for libzmq (Required)
+├── mt5-chart                   # The "Client": Rust Desktop App
+│   ├── src
+│   │   └── main.rs             # Main Application Logic (Subscribes & Plots)
+│   └── Cargo.toml              # Project Dependencies
+└── README.md                   
+
+```
+
+---
+
+## Functionality
+
+The system consists of two main components acting in a Publisher-Subscriber model data flow:
+
+### 1. The Publisher (MetaTrader 5 / MQL5)
+*   **Role**: The Data Source.
+*   **Implementation**: An Expert Advisor (`ZmqPublisher.mq5`) utilizing a custom ZMQ wrapper (`Zmq.mqh`).
+*   **Protocol**: Binds to a TCP HOST on port `5555`.
+*   **Operation**: On every incoming tick (`OnTick` data event), it:
+    *   Extracts Symbol, Bid price, Ask price, and Server Time.
+    *   Serializes this data into a JSON string.
+    *   Publishes it instantly to the ZMQ socket.
+
+### 2. The Subscriber (Rust)
+*   **Role**: The Data Consumer & Visualization.
+*   **Implementation**: A high-performance GUI application built with `eframe` (egui).
+*   **Protocol**: Connects to the TCP socket on `localhost:5555`.
+*   **Operation**:
+    *   **Asynchronous Data Ingestion**: A background `tokio` task listens for incoming ZMQ messages.
+    *   **Deserialization**: Parses the raw JSON bytes into Rust `TickData` structs.
+    *   **Real-time Plotting**: Updates an `egui_plot` chart at 60fps (or higher) to visualize the Bid/Ask spread in real-time.
+
+---
+
+## Installation & Usage
+
+### Prerequisites
+*   **MetaTrader 5** Client [*link*](https://www.metatrader5.com/) and it must already be connected to a Broker (use whatever broker you like)
+*   **Rust** (via `rustup`) [*link*](https://rust-lang.org/tools/install/) and configure its file path [*Link*](https://www.youtube.com/watch?v=2PmPWWTmfiU) on your computer.
+*   **Visual Studio Build Tools (C++)** (Required for Rust Linker) [*link*](https://visualstudio.microsoft.com/visual-cpp-build-tools/) select the C++ Build tools (in my case I've downloaded 6gb)
+
+### Step 1: MT5 Setup
+1.  Copy `MQL5/Experts/ZmqPublisher.mq5` to your MT5 Data Folder's `MQL5/Experts/`. *(relocate outside this repository, into your MT5 literal path directory)*<br>
+2.  Copy `MQL5/Include/Zmq/Zmq.mqh` to `MQL5/Include/Zmq/`. *(do the same for this)*<br>
+3.  **Crucial**: Download `libzmq.dll` and `libsodium.dll` (64-bit versions) and place them in `MQL5/Libraries`.<br>
+4.  Open the MT5 platform, look at the top of the screen. Go to **Tools -> Options -> Expert Advisors** and check **"Allow DLL imports"**.<br>
+5.  Open the MetaEditor5. Go to **Navigator (Ctrl+d) -> Experts -> and find ZmqPublisher.mq5**.  Select and compile 'ZmqPublisher.mq5' once.<br>
+6.  Go back to the MT5 platform. Drag and drop `ZmqPublisher` onto any chart.<br>
+7.  Check. Go to **Toolbox (ctrl+t) -> Journal** section, check if it says *Success Message*: `ZmqPublisher bound to tcp://0.0.0.0:5555`
+
+### Step 2: Rust Client Setup
+1.  Open a terminal (for instance: Windows PowerShell, not a code editor like VS Code) in the `mt5-chart` folder. Or simply copy the file path
+    ```bash
+    cd mt5-chart
+
+    # In my case, I will bash
+    cd C:\Users\User\Desktop\VSCode\Rust-ZMQ-MT5\mt5-chart
+    ```
+3.  Then run the application using another bash:
+    ```bash
+    cargo run --release
+    ```
+
+---
+
+## Common Errors & Troubleshooting
+
+This project combines three distinct technologies (Rust, MQL5, ZeroMQ) across two different runtime environments (MetaTrader 5 and Windows Desktop). This complexity can lead to specific errors. Below is a comprehensive guide to resolving every known issue.
+
+### 1. Critical: Antivirus & Terminal Permissions
+**Symptom**: `Access Denied`, `Terminated`, or the Rust window appears and immediately closes.
+*   **Cause**: Many Antivirus software (including Windows Defender) and built-in IDE terminals (like VS Code's integrated terminal) restrict programs from opening high-speed network sockets or interacting with other processes.
+*   **Fix**:
+    1.  **Do NOT use VS Code's Intergrated Terminal**. It often lacks the necessary permissions.
+    2.  Open a **standalone** Windows PowerShell instance as Administrator.
+    3.  Navigate to your project directory manually (`cd C:\Users\...\mt5-chart`).
+    4.  Run `cargo run --release` from there.
+
+### 2. MQL5: "Access Violation" / Crash on Load
+**Symptom**: MetaTrader 5 crashes instantly when you drag the EA onto a chart, or the EA simply disappears from the chart "smiling face" icon.
+*   **Cause**: **64-bit Pointer Truncation**. The original MQL5 language was often used on 32-bit systems where an `int` (4 bytes) was the same size as a pointer. On modern 64-bit MT5, pointers are 8 bytes (`long`). If you cast a pointer to an `int`, you lose half the memory address, causing an immediate crash when the program tries to access that invalid location.
+*   **Fix**:
+    *   Never use `int` for handles. Use `long` or `intptr_t`.
+    *   Our provided `Zmq.mqh` has been patched to use `long` for all socket context and socket handles. Ensure you are completely replacing your old `Zmq.mqh` with the one from this repository.
+
+### 3. MQL5: "Error 126" (Cannot Load Library)
+**Symptom**: The Expert Advisor log shows `Cannot load 'libzmq.dll' [126]`.
+*   **Cause**: This error means "Module Not Found". It happens for one of three reasons:
+    1.  **Missing DLL**: You didn't put `libzmq.dll` in the `MQL5/Libraries` folder.
+    2.  **Missing Dependency**: `libzmq.dll` itself depends on `libsodium.dll` and the **Visual C++ Redistributable**. If *those* are missing, `libzmq.dll` will fail to load, triggering the same header error.
+    3.  **Architecture Mismatch**: You downloaded a 32-bit DLL for a 64-bit MT5 terminal (or vice versa).
+*   **Fix**:
+    *   Ensure both `libzmq.dll` AND `libsodium.dll` are in `MQL5/Libraries`.
+    *   Ensure you downloaded the **x64 (64-bit)** versions of these DLLs.
+    *   Install the latest **Microsoft Visual C++ Redistributable** (x64).
+
+### 4. MQL5: "Error 22" (Invalid Argument) during Bind
+**Symptom**: The EA loads, but the Journal says `ZmqPublisher: Bind failed with error 22`.
+*   **Cause 1**: **Binding to Wildcard**. Defaulting to `tcp://*:5555` works on Linux but can fail on specific Windows network configurations or Firewall setups.
+    *   **Fix**: Change the bind address in your code (or input settings) to `tcp://0.0.0.0:5555` to explicitly bind to all interfaces, or `tcp://127.0.0.1:5555` for local-only.
+*   **Cause 2**: **String Encoding**. MQL5 uses `wchar_t` (Unicode) for strings internally. ZeroMQ demands C-style standard ASCII/UTF-8 strings. Passing a raw MQL string to the DLL sends garbage bytes.
+    *   **Fix**: The `Zmq.mqh` wrapper must use `StringToCharArray` to convert the string to a byte array before passing it to `zmq_bind`.
+
+### 5. MQL5: "DLL Imports Not Allowed"
+**Symptom**: `Expert 'ZmqPublisher' cannot be loaded because DLL imports are not allowed`.
+*   **Cause**: Security setting in MT5.
+*   **Fix**: Go to **Tools -> Options -> Expert Advisors** and check the box **"Allow DLL imports"**. This is mandatory.
+
+### 6. Rust: "Linker 'link.exe' not found"
+**Symptom**: `cargo run` fails with a massive wall of red text mentioning `link.exe` or `msvc`.
+*   **Cause**: Rust on Windows (MSVC version) relies on the Microsoft C++ Linker, which is not installed by default with Windows.
+*   **Fix**:
+    1.  Download the **Visual Studio Build Tools**.
+    2.  In the installer, select **"Desktop development with C++"**.
+    3.  Ensure the "MSVC ... -C++ x64/x86 build tools" component is checked on the right side.
+    4.  Install (approx. 5-6GB).
+
+### 7. Rust: "OS Error 32" (File used by another process)
+**Symptom**: `error: linking with link.exe failed` or `Access is denied` when trying to run/build.
+*   **Cause**: The compiled executable (`mt5-chart.exe`) is currently running, or is locked by:
+    *   A previous instance that didn't close properly.
+    *   The VS Code underlying process.
+    *   Your Antivirus scanning the new `.exe`.
+*   **Fix**:
+    1.  **Close the GUI window** fully.
+    2.  If it persists, open Task Manager and kill `mt5-chart.exe`.
+    3.  Run `cargo clean` to wipe the locked artifact, then `cargo run --release` again.
+
+### 8. Generic: ZeroMQ Message Format Mismatches
+**Symptom**: Rust client connects but panics with `Error parsing JSON` or prints weird symbols.
+*   **Cause**: The MQL5 Publisher and Rust Subscriber must agree *exactly* on the data format. If MQL5 sends `{"bid": ...}` but Rust expects `{"Bid": ...}` (case sensitivity) or if MQL5 sends a trailing null byte `\0` that JSON parsers hate.
+*   **Fix**:
+    *   Ensure the JSON structure key names match exactly.
+    *   In Rust, strip the trailing null character if necessary: `msg.trim_matches(char::from(0))`.
+
+### 9. Generic: "Address in Use" (EADDRINUSE)
+**Symptom**: You restart the EA and it says `Bind failed`.
+*   **Cause**: You cannot bind to port 5555 if something is already bound to it. Often, when you remove an EA, MT5 might not release the DLL handle instantly, keeping the socket open.
+*   **Fix**: Restart the MetaTrader 5 terminal completely to force-close all DLL handles.
+
+---
+
+## Citation
+
+If you use this project in your research or application, please cite it as follows:
+
+```bibtex
+@software{RustZmqMt5,
+  author = {Albeos, Rembrant Oyangoren},
+  title = {Rust + ZMQ + MT5's MQL5: Exploiting Micro-Second BID/ASK Live Trading Data},
+  year = {2026},
+  url = {https://github.com/unban-algorembrant/Rust-ZMQ-MQL5},
+  note = {First known implementation for exploiting micro-second live BID/ASK trading data using Rust + ZMQ + MT5's MQL5}
+}
+```

STRUCTURE.md

@@ -0,0 +1,85 @@
+## Project Structure
+
+```text
+Rust-ZMQ-MQL5/
+├── funny replies/
+│   ├── funny1.png
+│   ├── funny2.png
+│   ├── funny3.png
+│   └── funny4.png
+├── MQL5/
+│   ├── Experts/
+│   │   └── ZmqPublisher.mq5
+│   └── Include/
+│       └── Zmq/
+│           └── Zmq.mqh
+├── mt5-chart/
+│   ├── src/
+│   │   └── main.rs
+│   ├── Cargo.lock
+│   └── Cargo.toml
+├── search/
+│   ├── arxiv/
+│   │   ├── arxiv1.png
+│   │   ├── arxiv2.png
+│   │   ├── arxiv3.png
+│   │   ├── arxiv4.png
+│   │   ├── arxiv5.png
+│   │   ├── arxiv6.png
+│   │   ├── arxiv7.png
+│   │   ├── arxiv8.png
+│   │   └── arxiv9.png
+│   ├── baiduscholarly/
+│   │   ├── baiduscholarly1.png
+│   │   ├── baiduscholarly2.png
+│   │   ├── baiduscholarly3.png
+│   │   ├── baiduscholarly4.png
+│   │   ├── baiduscholarly5.png
+│   │   ├── baiduscholarly6.png
+│   │   ├── baiduscholarly7.png
+│   │   ├── baiduscholarly8.png
+│   │   └── baiduscholarly9.png
+│   ├── googlescholar/
+│   │   ├── gscholar1.png
+│   │   ├── gscholar2.png
+│   │   ├── gscholar3.png
+│   │   ├── gscholar4.png
+│   │   ├── gscholar5.png
+│   │   ├── gscholar6.png
+│   │   ├── gscholar7.png
+│   │   ├── gscholar8.png
+│   │   └── gscholar9.png
+│   ├── ssrn/
+│   │   ├── ssrn1.png
+│   │   ├── ssrn2.png
+│   │   ├── ssrn3.png
+│   │   ├── ssrn4.png
+│   │   ├── ssrn5.png
+│   │   ├── ssrn6.png
+│   │   ├── ssrn7.png
+│   │   ├── ssrn8.png
+│   │   └── ssrn9.png
+│   ├── scholar.md
+│   └── search.txt
+├── survey/
+│   ├── ans1.png
+│   ├── ans2.png
+│   ├── ans3.png
+│   ├── ans4.png
+│   ├── ans5.png
+│   ├── ans6.png
+│   ├── ans7.png
+│   ├── ans8.png
+│   ├── ans9.png
+│   └── grok's validation to my proof-of-work.png
+├── 2026-01-20 20-32-35.mp4
+├── 2026-01-21 10-45-20.mp4
+├── 2026-01-21 14-03-26.mp4
+├── 2026-01-22 08-42-06.mp4
+├── 2026-01-22 10-09-23.mp4
+├── Install VisualStudio C++ Build Tools.png
+├── LICENSE
+├── README.md
+├── summary.md
+└── TECHSTACK.md
+```

TECHSTACK.md

@@ -0,0 +1,17 @@
+## Techstack
+
+Audit of **Rust-ZMQ-MQL5** project files (excluding environment and cache):
+
+| File Type | Count | Size (KB) |
+| :--- | :--- | :--- |
+| PNG Image (.png) | 51 | 5,126.5 |
+| MP4 Video (.mp4) | 5 | 23,107.9 |
+| Markdown (.md) | 3 | 23.4 |
+| (no extension) | 1 | 1.1 |
+| Lock File (.lock) | 1 | 112.6 |
+| MQL Header (.mqh) | 1 | 3.1 |
+| MQL5 Source (.mq5) | 1 | 2.7 |
+| Plain Text (.txt) | 1 | 0.1 |
+| Rust (.rs) | 1 | 4.5 |
+| TOML (.toml) | 1 | 0.3 |
+| **Total** | **66** | **28,382.1** |

mt5-chart/Cargo.toml

@@ -0,0 +1,14 @@
+[package]
+name = "mt5-chart"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+eframe = "0.27.1"
+egui = "0.27.1"
+egui_plot = "0.27.1"
+zeromq = "0.5.0-pre"
+serde = { version = "1.0.197", features = ["derive"] }
+serde_json = "1.0.114"
+tokio = { version = "1.36.0", features = ["full"] }
+futures = "0.3.30"

mt5-chart/src/main.rs

@@ -0,0 +1,127 @@
+use eframe::egui;
+use egui_plot::{Line, Plot, PlotPoints};
+use serde::Deserialize;
+use std::sync::Arc;
+use tokio::sync::mpsc;
+use zeromq::{Socket, SocketRecv};
+
+#[derive(Clone, Debug, Deserialize)]
+struct TickData {
+    symbol: String,
+    bid: f64,
+    ask: f64,
+    time: i64,
+}
+
+struct Mt5ChartApp {
+    receiver: mpsc::Receiver<TickData>,
+    data: Vec<TickData>,
+    symbol: String,
+}
+
+impl Mt5ChartApp {
+    fn new(receiver: mpsc::Receiver<TickData>) -> Self {
+        Self {
+            receiver,
+            data: Vec::new(),
+            symbol: "Waiting for data...".to_string(),
+        }
+    }
+}
+
+impl eframe::App for Mt5ChartApp {
+    fn update(&mut self, ctx: &egui::Context, _frame: &mut eframe::Frame) {
+        // Receive all available data from the channel without blocking
+        while let Ok(tick) = self.receiver.try_recv() {
+            self.symbol = tick.symbol.clone();
+            self.data.push(tick);
+            // Keep only last 1000 points to avoid memory issues for this demo
+            if self.data.len() > 1000 {
+                self.data.remove(0);
+            }
+        }
+
+        egui::CentralPanel::default().show(ctx, |ui| {
+            ui.heading(format!("MT5 Live Chart: {}", self.symbol));
+            if let Some(last_tick) = self.data.last() {
+                ui.label(format!("Bid: {:.5} | Ask: {:.5}", last_tick.bid, last_tick.ask));
+            }
+
+            let plot = Plot::new("mt5_plot")
+                .view_aspect(2.0)
+                .legend(egui_plot::Legend::default());
+
+            plot.show(ui, |plot_ui| {
+                let bid_points: PlotPoints = self.data
+                    .iter()
+                    .enumerate()
+                    .map(|(i, t)| [i as f64, t.bid])
+                    .collect();
+                
+                let ask_points: PlotPoints = self.data
+                    .iter()
+                    .enumerate()
+                    .map(|(i, t)| [i as f64, t.ask])
+                    .collect();
+
+                plot_ui.line(Line::new(bid_points).name("Bid").color(egui::Color32::from_rgb(100, 200, 100)));
+                plot_ui.line(Line::new(ask_points).name("Ask").color(egui::Color32::from_rgb(200, 100, 100)));
+            });
+        });
+
+        // Request a repaint to update the chart continuously
+        ctx.request_repaint();
+    }
+}
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let (tx, rx) = mpsc::channel(100);
+
+    // Spawn ZMQ Subscriber task
+    tokio::spawn(async move {
+        // ZMQ Context and Socket
+        let mut socket = zeromq::SubSocket::new();
+        match socket.connect("tcp://127.0.0.1:5555").await {
+            Ok(_) => println!("Connected to ZMQ Publisher"),
+            Err(e) => eprintln!("Failed to connect to ZMQ: {}", e),
+        }
+        
+        let _ = socket.subscribe("").await;
+
+        loop {
+             match socket.recv().await {
+                Ok(msg) => {
+                    // msg is a MultiPart message, usually the first part depends on subscription
+                    // In our simple case, payload is likely in the first frame or the whole string
+                    if let Some(payload_bytes) = msg.get(0) {
+                         if let Ok(json_str) = std::str::from_utf8(payload_bytes) {
+                             // Attempt to parse JSON
+                             // The MT5 EA sends: {"symbol":..., "bid":..., ...}
+                             match serde_json::from_str::<TickData>(json_str) {
+                                 Ok(tick) => {
+                                     if let Err(e) = tx.send(tick).await {
+                                         eprintln!("Channel error: {}", e);
+                                         break;
+                                     }
+                                 }
+                                 Err(e) => eprintln!("JSON Parse Error: {}. Msg: {}", e, json_str),
+                             }
+                         }
+                    }
+                }
+                Err(e) => {
+                    eprintln!("ZMQ Recv Error: {}", e);
+                    tokio::time::sleep(tokio::time::Duration::from_millis(1000)).await;
+                }
+             }
+        }
+    });
+
+    let options = eframe::NativeOptions::default();
+    eframe::run_native(
+        "Rust + ZMQ + MT5's MQL5 Chart",
+        options,
+        Box::new(|_cc| Box::new(Mt5ChartApp::new(rx))),
+    ).map_err(|e| e.into())
+}

search/scholar.md

@@ -0,0 +1,66 @@
+<b>Scholarly Validation</b>:
+<table cellspacing="0" cellpadding="0">
+  <tr>
+    <td><img src="arxiv/arxiv1.png" alt=""></td>
+    <td><img src="arxiv/arxiv2.png" alt=""></td>
+    <td><img src="arxiv/arxiv3.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="arxiv/arxiv4.png" alt=""></td>
+    <td><img src="arxiv/arxiv5.png" alt=""></td>
+    <td><img src="arxiv/arxiv6.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="arxiv/arxiv7.png" alt=""></td>
+    <td><img src="arxiv/arxiv8.png" alt=""></td>
+    <td><img src="arxiv/arxiv9.png" alt=""></td>
+  </tr>
+
+  <tr>
+    <td><img src="baiduscholarly/baiduscholarly1.png" alt=""></td>
+    <td><img src="baiduscholarly/baiduscholarly2.png" alt=""></td>
+    <td><img src="baiduscholarly/baiduscholarly3.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="baiduscholarly/baiduscholarly4.png" alt=""></td>
+    <td><img src="baiduscholarly/baiduscholarly5.png" alt=""></td>
+    <td><img src="baiduscholarly/baiduscholarly6.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="baiduscholarly/baiduscholarly7.png" alt=""></td>
+    <td><img src="baiduscholarly/baiduscholarly8.png" alt=""></td>
+    <td><img src="baiduscholarly/baiduscholarly9.png" alt=""></td>
+  </tr>
+
+  <tr>
+    <td><img src="googlescholar/gscholar1.png" alt=""></td>
+    <td><img src="googlescholar/gscholar2.png" alt=""></td>
+    <td><img src="googlescholar/gscholar3.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="googlescholar/gscholar4.png" alt=""></td>
+    <td><img src="googlescholar/gscholar5.png" alt=""></td>
+    <td><img src="googlescholar/gscholar6.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="googlescholar/gscholar7.png" alt=""></td>
+    <td><img src="googlescholar/gscholar8.png" alt=""></td>
+    <td><img src="googlescholar/gscholar9.png" alt=""></td>
+  </tr>
+
+  <tr>
+    <td><img src="ssrn/ssrn1.png" alt=""></td>
+    <td><img src="ssrn/ssrn2.png" alt=""></td>
+    <td><img src="ssrn/ssrn3.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="ssrn/ssrn4.png" alt=""></td>
+    <td><img src="ssrn/ssrn5.png" alt=""></td>
+    <td><img src="ssrn/ssrn6.png" alt=""></td>
+  </tr>
+  <tr>
+    <td><img src="ssrn/ssrn7.png" alt=""></td>
+    <td><img src="ssrn/ssrn8.png" alt=""></td>
+    <td><img src="ssrn/ssrn9.png" alt=""></td>
+  </tr>
+</table>

search/search.txt

@@ -0,0 +1 @@
+combination of Rust, ZeroMQ (ZMQ), and MT5's MQL5 to get live bid/ask orderflow data from MetaTrader5 (MT5)