Files
xMQL5/MQL5/Projects/XTEST/Providers/x-saherelm.xtest.provider.inputs.lib.mq5
T
2024-05-17 21:12:22 +03:30

283 lines
8.6 KiB
Plaintext

///////////////////////////////////////////////////////////////
//
// SaherElm IT Center MQL5 XTEST Signal Provider Library Inputs
// -----------------------------------------------------------
//
// Maintainer:
// ------------
// Hadi Khazaee Asl (hadi_khazaee_asl@yahoo.com)
//
//////////////////////////////////////////////////////
//
// Global Properties ...
#property library
#property copyright "Copyright 2023, SaherElm IT Center"
#property link "https://www.saherelm.ir"
#property version "1.00"
#property strict
//
// Include Logger ...
#include "../Libraries/x-saherelm.log.lib.mq5"
//
// Include Classes ...
#include "../Classes/x-saherelm.class.lib.mq5"
//
input group "XTEST Provider";
//
// Commonly Used Configurations ...
input group "XTEST Common";
//
// Provider ...
input bool xTESTEnableProvider = true; // Enable Provider
input int xTESTNumberOfItemsPerTick = 30; // Number Of items Readed In Each Tick
//
// Alerts ...
input bool xTESTEnableAlerts = true; // Enable Events Alert
input bool xTESTEnableHourlyAlerts = false; // Send Alert on each new Hour
input bool xTESTEnableDailyAlerts = false; // Send Alert on each new Day
input bool xTESTEnableWeeklyAlerts = false; // Send Alert on each new Week
input bool xTESTEnableMonthlyAlerts = false; // Send Alert on each new Month
//
// Reports ...
input bool xTESTEnableDailyReports = false; // Send Report on each new Day
input bool xTESTEnableWeeklyReports = false; // Send Report on each new Week
input bool xTESTEnableMonthlyReports = false; // Send Report on each new Month
//
// Trader and Expert Specific Configurations ...
input group "XTEST Trader";
input int xTESTMagicNumber = 16940563; // Trader MagicNumber
input int xTESTSlippage = 10; // Trader Slippage
//
// Trades Management Configurations ...
input group "XTEST Trade Management";
input bool xTESTAllowLongTrades = true; // Allow Long Trades
input bool xTESTAllowShortTrades = true; // Allow Short Trades
//
// Risk Management Configurations ...
input group "XTEST Risk Management";
//
// Trade Count ...
input int xTESTMaxAllowedTrades = 10; // Max Allowed Trades at Same Time
input ENUM_X_CROSS_SIGNAL_METHOD xTESTCrossSignalsMethod = X_CROSS_SIGNAL_REGULAR; // Handle Cross Signals Method
//
// Max Allowed Trade Age ...
input int xTESTMaxAllowedTradeAge = 300; // Detect Long Time Trades
input ENUM_X_GUARD_ACTIONS xTESTOldTradesAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_1; // What to do with Old Trades
//
// Trade Volume Specific Configurations ...
input double xTESTStaticVolumeFactor = 0.0004; // Static Volume baesd on Balance
input ENUM_STATIC_VOLUME_METHODS xTESTStaticVolumeMethod = X_STATIC_VOLUME_BASED_ON_BALANCE; // How to Calculate Static Volume
input double xTESTVolumeMultiplier = 0; // Volume Increase Multiplier
input double xTESTApplyVolumeMultiplierFactor = 0; // Apply Volume Multiplier Rate based on Balance
input double xTESTMaxSupportedVolumePerTradeFactor = 0; // Max Supported Volume Per Trade Factor based on Balance
input double xTESTIncreasedMaxSupportedVolumeRate = 0; // Increase Max Supported Volume based on Balance
//
// Trade Profits ...
input double xTESTMinRewardInPips = 60; // Minimum Reward Per Trade in Pips
input double xTESTRiskFreeStepInPips = 0; // Make Trades Risk Free Steps in Pips
input double xTESTRiskFreeRate = 0; // Volume Multiplier for Risk Free Trades
//
// Guard Riskable Money and Profits ...
input double xTESTCriticalDrawDownFactor = 0.10; // Critical Allowed Drawdown Factor based on Balance
input ENUM_X_GUARD_ACTIONS xTESTCriticalGuardAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_1; // Specify Guard Action on Critical Drawdown
input double xTESTMaxAllowedDrawDownFactor = 0.15; // Max Allowed Drawdown Factor based on Balance
input ENUM_X_GUARD_ACTIONS xTESTMaxAllowedGuardAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_5; // Specify Guard Action on Max Allowed Drawdown
input int xTESTGuardStopoutFiredAfterTouches = 5; // Guard Stopout all Trades if Max Allowed Drawdown touched
//
// Account Conditions for Trading ...
input double xTESTBalanceFactorForOpenTrades = 0.5; // Minimum Balance for Open Trades
input double xTESTFreeMarginFactorForOpenTrades = 0.8; // Minimum Free Margin for Open Trades
//
// May be Used Later as Input Params ...
bool xTESTUseVirtualTPSl = false; // Use Virtual TP SL
bool xTESTEnableSignalAlerts = false; // Send Signal Alert
//
// Validate Inputs before Initialization ...
bool XTESTValidateInputs()
{
//
bool result = false;
//
// Implement Other Verifications ...
//
// Check Trading Availability ...
bool isTradeAvailable = xTESTAllowLongTrades || xTESTAllowShortTrades;
if (!isTradeAvailable)
{
LogMessage("XTEST => Warning: Trading disabled ...");
}
//
// Chekc Number of reading items per tick ...
result = xTESTNumberOfItemsPerTick >= 5;
if (!result)
{
//
LogMessage("XTEST invalid Number of items Reading Per Tick ...");
//
return result;
}
//
// Check Max Allowed Trades Count ...
result = isTradeAvailable && xTESTMaxAllowedTrades >= 1;
if (!result)
{
//
LogMessage("XTEST Number of Trades not valid ...");
//
return result;
}
//
// Check Free Margin ...
result =
isTradeAvailable &&
xTESTFreeMarginFactorForOpenTrades > 0 &&
xTESTFreeMarginFactorForOpenTrades < 1;
if (!result)
{
//
LogMessage("XTEST Invalid Free Margin ...");
//
return result;
}
//
// Check min Balance for Open Trades ...
result =
isTradeAvailable &&
xTESTBalanceFactorForOpenTrades > 0 &&
xTESTBalanceFactorForOpenTrades < 1;
if (!result)
{
//
LogMessage("XTEST Invalid Min Balance for Open Trades ...");
//
return result;
}
//
// Check Min Reward Per Trade ...
result = xTESTMinRewardInPips > 0;
if (!result)
{
//
LogMessage("XTEST Invalid Min Reward Per Trade ...");
//
return result;
}
//
// Check Trades Volume ...
result = xTESTStaticVolumeFactor > 0;
if (!result)
{
//
LogMessage("XTEST Invalid Static Volume ...");
//
return result;
}
//
// Check Volume Multiplier ...
result = xTESTVolumeMultiplier >= 0;
if (!result)
{
//
LogMessage("XTEST Invalid Volume Multiplier ...");
//
return result;
}
//
result =
xTESTCriticalDrawDownFactor == 0 || (xTESTCriticalDrawDownFactor > 0 &&
xTESTCriticalDrawDownFactor < 1);
if (!result)
{
//
LogMessage("XTEST Invalid Critical DrawDown Factor ...");
//
return result;
}
//
result =
xTESTMaxAllowedDrawDownFactor == 0 || (xTESTMaxAllowedDrawDownFactor > 0 &&
xTESTMaxAllowedDrawDownFactor < 1);
if (!result)
{
//
LogMessage("XTEST Invalid Max Allowed DrawDown Factor ...");
//
return result;
}
//
// Check Guard Actions ...
//
result =
xTESTCriticalDrawDownFactor > 0 &&
xTESTCriticalDrawDownFactor < 1 &&
xTESTMaxAllowedDrawDownFactor > 0 &&
xTESTMaxAllowedDrawDownFactor < 1;
if (!result)
{
//
LogMessage("XTEST For Critical Drawdown, you have to Specify Max Drawdown also ...");
//
return result;
}
//
result = xTESTCriticalDrawDownFactor > 0 && xTESTCriticalDrawDownFactor < xTESTMaxAllowedDrawDownFactor;
if (!result)
{
//
LogMessage("XTEST Critical Drawdown must Smaller than Max Drawdown ...");
//
return result;
}
//
if (xTESTCriticalDrawDownFactor > 0 && xTESTCriticalGuardAction == X_GUARD_DO_NOTHING)
{
LogMessage("XTEST IMPORTANT you Specified Critical Drawdown, but there is no any Guard Action ...");
}
//
if (xTESTMaxAllowedDrawDownFactor > 0 && xTESTMaxAllowedGuardAction == X_GUARD_DO_NOTHING)
{
LogMessage("XTEST IMPORTANT you Specified Max Allowed Drawdown, but there is no any Guard Action ...");
}
//
result = true;
//
return result;
}