DWX Connect

DWX Connect links trading strategies to Darwinex via MetaTrader 4 or 5. Follow these steps to set up the environment:

1. Download the repository from GitHub.
2. Install the MetaTrader Server EA:
   • Download dwx_server_mt4.mq4 (for MT4) or dwx_server_mt5.mq5 (for MT5).
   • Copy the file into your MT4/MT5 data folder under /MQL4/Experts or /MQL5/Experts.
   • Open the file in MetaEditor and press F7 to compile it.
   • Restart MetaTrader or refresh the Navigator window, then attach the EA to a chart.
3. Configure the Python side:
   • Copy the python/ folder to your working directory.
   • Open dwx_client_example.py and update the MT4_files_dir variable to point to your MetaTrader /MQL4/Files or /MQL5/Files directory.
     • Windows example: C:/Users/<username>/AppData/Roaming/MetaQuotes/Terminal/.../MQL4/Files
     • macOS example: /Users/<username>/Library/Application Support/MetaTrader 4/Bottles/metatrader4/drive_c/Program Files/MetaTrader 4/MQL4/Files
     • Linux example: /home/<username>/.wine/drive_c/Program Files (x86)/Darwinex MT4/MQL4/Files
4. Run the example:

   python dwx_client_example.py

Warning: Use a Darwinex demo account for testing. Do not run test scripts on a live account.

To use DWX_Connect with Java, you must first configure the MetaTrader (MT4/MT5) side by installing the Server EA, and then set up your Java environment.

1. MetaTrader Configuration

1. Download the DWX_Connect repository.
2. Copy the server EA (DWX_Server_MT4.mq4 for MT4 or DWX_Server_MT5.mq5 for MT5) into your MT4/MT5 data folder under /MQL4/Experts or /MQL5/Experts.
3. Open the EA in MetaEditor and press F7 to compile it.
4. Restart MetaTrader or refresh the Navigator window.
5. Attach the EA to a chart. You can adjust input parameters like MaximumOrders and MaximumLotSize in the EA settings.

2. Java Environment Setup

1. Ensure the Java Development Kit (JDK) is installed and added to your system PATH.
2. Copy the contents of the java/ directory from the DWX_Connect repository into your local working directory.
3. Use DWXExampleClient.java as a template for your own trading algorithm.

To use DWX_Connect with C#, follow these steps to configure both the MetaTrader server and your local development environment:

1. Configure MetaTrader (MT4/MT5)

1. Download the DWX_Connect source code from GitHub.
2. Locate the server EA file (DWX_Server_MT4.mq4 for MT4 or DWX_Server_MT5.mq5 for MT5).
3. Copy the EA file into your MetaTrader data folder under /MQL4/Experts or /MQL5/Experts.
4. Open the file in MetaEditor, compile it by pressing F7, and then refresh your Navigator window in MT4/MT5.
5. Attach the EA to a chart. You can adjust input parameters such as MaximumOrders and MaximumLotSize within the EA settings.

2. Configure C# Environment

1. Copy the contents of the dotnet/DWX_Connect directory into your project's working directory.
2. Use DWXExampleClient.cs as a template for your custom trading algorithm.
3. Build and run the application using the .NET CLI.

# Build the project
dotnet build

# Run the application
dotnet run

The MetaTrader Server EA (MT4/MT5) can be customized via input parameters. The most critical ones for trading are MaximumOrders and MaximumLotSize.

The Client class is the primary entry point for communicating with MetaTrader 4 or 5. To instantiate it, you must provide an EventHandler to handle incoming data events, the directory path where MetaTrader is installed, and several configuration parameters for timing and reliability.

Constructor Parameters:

• EventHandler eventHandler: An implementation of the EventHandler interface to receive callbacks (e.g., onTick, onOrderEvent).
• String MetaTraderDirPath: The local filesystem path to the MetaTrader installation directory.
• int sleepDelay: Delay in milliseconds between file checks.
• int maxRetryCommandSeconds: Maximum time in seconds to retry sending a command if the command files are currently being processed by MetaTrader.
• boolean loadOrdersFromFile: If true, the client will attempt to load existing orders from DWX_Orders_Stored.txt to maintain state across restarts.
• boolean verbose: If true, enables detailed logging to the console.

// Example initialization
EventHandler myHandler = new MyEventHandler();
Client client = new Client(myHandler, "C:/Program Files/MetaTrader 5", 100, 5, true, true);

To interact with MT4/MT5, instantiate the Client class. The constructor requires an EventHandler to receive updates, the path to your MetaTrader directory, and several configuration parameters for polling and retries.

Constructor Parameters:

• eventHandler: An instance of EventHandler to handle incoming data events.
• MetaTraderDirPath: The directory where MetaTrader is installed (must exist).
• sleepDelay: Time in milliseconds to wait between file checks.
• maxRetryCommandSeconds: Maximum time to retry sending a command if the command files are busy.
• loadOrdersFromFile: Boolean; if true, the client will attempt to reload existing orders from DWX_Orders_Stored.txt upon startup.
• verbose: Boolean; if true, enables detailed logging of order changes.

// Example initialization
Client client = new Client(myEventHandler, "C:\Program Files\MetaTrader 5", 100, 5, true, true);