Files
MQL5Data/Providers/x-saherelm.xgpus5.provider.inputs.lib.mq5
T

283 lines
8.7 KiB
Plaintext

///////////////////////////////////////////////////////////////
//
// SaherElm IT Center MQL5 XGPUS5 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 "XGPUS5 Provider";
//
// Commonly Used Configurations ...
input group "XGPUS5 Common";
//
// Provider ...
input bool xGPUS5EnableProvider = true; // Enable Provider
input int xGPUS5NumberOfItemsPerTick = 30; // Number Of items Readed In Each Tick
//
// Alerts ...
input bool xGPUS5EnableAlerts = true; // Enable Events Alert
input bool xGPUS5EnableHourlyAlerts = false; // Send Alert on each new Hour
input bool xGPUS5EnableDailyAlerts = false; // Send Alert on each new Day
input bool xGPUS5EnableWeeklyAlerts = false; // Send Alert on each new Week
input bool xGPUS5EnableMonthlyAlerts = false; // Send Alert on each new Month
//
// Reports ...
input bool xGPUS5EnableDailyReports = false; // Send Report on each new Day
input bool xGPUS5EnableWeeklyReports = false; // Send Report on each new Week
input bool xGPUS5EnableMonthlyReports = false; // Send Report on each new Month
//
// Trader and Expert Specific Configurations ...
input group "XGPUS5 Trader";
input int xGPUS5MagicNumber = 16940563; // Trader MagicNumber
input int xGPUS5Slippage = 10; // Trader Slippage
//
// Trades Management Configurations ...
input group "XGPUS5 Trade Management";
input bool xGPUS5AllowLongTrades = true; // Allow Long Trades
input bool xGPUS5AllowShortTrades = true; // Allow Short Trades
//
// Risk Management Configurations ...
input group "XGPUS5 Risk Management";
//
// Trade Count ...
input int xGPUS5MaxAllowedTrades = 10; // Max Allowed Trades at Same Time
input ENUM_X_CROSS_SIGNAL_METHOD xGPUS5CrossSignalsMethod = X_CROSS_SIGNAL_REGULAR; // Handle Cross Signals Method
//
// Max Allowed Trade Age ...
input int xGPUS5MaxAllowedTradeAge = 300; // Detect Long Time Trades
input ENUM_X_GUARD_ACTIONS xGPUS5OldTradesAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_1; // What to do with Old Trades
//
// Trade Volume Specific Configurations ...
input double xGPUS5StaticVolumeFactor = 0.0004; // Static Volume baesd on Balance
input ENUM_STATIC_VOLUME_METHODS xGPUS5StaticVolumeMethod = X_STATIC_VOLUME_BASED_ON_BALANCE; // How to Calculate Static Volume
input double xGPUS5VolumeMultiplier = 0; // Volume Increase Multiplier
input double xGPUS5ApplyVolumeMultiplierFactor = 0; // Apply Volume Multiplier Rate based on Balance
input double xGPUS5MaxSupportedVolumePerTradeFactor = 0; // Max Supported Volume Per Trade Factor based on Balance
input double xGPUS5IncreasedMaxSupportedVolumeRate = 0; // Increase Max Supported Volume based on Balance
//
// Trade Profits ...
input double xGPUS5MinRewardInPips = 6.0; // Minimum Reward Per Trade in Pips
input double xGPUS5RiskFreeStepInPips = 0; // Make Trades Risk Free Steps in Pips
input double xGPUS5RiskFreeRate = 0; // Volume Multiplier for Risk Free Trades
//
// Guard Riskable Money and Profits ...
input double xGPUS5CriticalDrawDownFactor = 0.10; // Critical Allowed Drawdown Factor based on Balance
input ENUM_X_GUARD_ACTIONS xGPUS5CriticalGuardAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_1; // Specify Guard Action on Critical Drawdown
input double xGPUS5MaxAllowedDrawDownFactor = 0.15; // Max Allowed Drawdown Factor based on Balance
input ENUM_X_GUARD_ACTIONS xGPUS5MaxAllowedGuardAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_5; // Specify Guard Action on Max Allowed Drawdown
input int xGPUS5GuardStopoutFiredAfterTouches = 5; // Guard Stopout all Trades if Max Allowed Drawdown touched
//
// Account Conditions for Trading ...
input double xGPUS5BalanceFactorForOpenTrades = 0.5; // Minimum Balance for Open Trades
input double xGPUS5FreeMarginFactorForOpenTrades = 0.8; // Minimum Free Margin for Open Trades
//
// May be Used Later as Input Params ...
bool xGPUS5UseVirtualTPSl = false; // Use Virtual TP SL
bool xGPUS5EnableSignalAlerts = false; // Send Signal Alert
//
// Validate Inputs before Initialization ...
bool XGPUS5ValidateInputs()
{
//
bool result = false;
//
// Implement Other Verifications ...
//
// Check Trading Availability ...
bool isTradeAvailable = xGPUS5AllowLongTrades || xGPUS5AllowShortTrades;
if (!isTradeAvailable)
{
LogMessage("XGPUS5 => Warning: Trading disabled ...");
}
//
// Chekc Number of reading items per tick ...
result = xGPUS5NumberOfItemsPerTick >= 5;
if (!result)
{
//
LogMessage("XGPUS5 invalid Number of items Reading Per Tick ...");
//
return result;
}
//
// Check Max Allowed Trades Count ...
result = isTradeAvailable && xGPUS5MaxAllowedTrades >= 1;
if (!result)
{
//
LogMessage("XGPUS5 Number of Trades not valid ...");
//
return result;
}
//
// Check Free Margin ...
result =
isTradeAvailable &&
xGPUS5FreeMarginFactorForOpenTrades > 0 &&
xGPUS5FreeMarginFactorForOpenTrades < 1;
if (!result)
{
//
LogMessage("XGPUS5 Invalid Free Margin ...");
//
return result;
}
//
// Check min Balance for Open Trades ...
result =
isTradeAvailable &&
xGPUS5BalanceFactorForOpenTrades > 0 &&
xGPUS5BalanceFactorForOpenTrades < 1;
if (!result)
{
//
LogMessage("XGPUS5 Invalid Min Balance for Open Trades ...");
//
return result;
}
//
// Check Min Reward Per Trade ...
result = xGPUS5MinRewardInPips > 0;
if (!result)
{
//
LogMessage("XGPUS5 Invalid Min Reward Per Trade ...");
//
return result;
}
//
// Check Trades Volume ...
result = xGPUS5StaticVolumeFactor > 0;
if (!result)
{
//
LogMessage("XGPUS5 Invalid Static Volume ...");
//
return result;
}
//
// Check Volume Multiplier ...
result = xGPUS5VolumeMultiplier >= 0;
if (!result)
{
//
LogMessage("XGPUS5 Invalid Volume Multiplier ...");
//
return result;
}
//
result =
xGPUS5CriticalDrawDownFactor == 0 || (xGPUS5CriticalDrawDownFactor > 0 &&
xGPUS5CriticalDrawDownFactor < 1);
if (!result)
{
//
LogMessage("XGPUS5 Invalid Critical DrawDown Factor ...");
//
return result;
}
//
result =
xGPUS5MaxAllowedDrawDownFactor == 0 || (xGPUS5MaxAllowedDrawDownFactor > 0 &&
xGPUS5MaxAllowedDrawDownFactor < 1);
if (!result)
{
//
LogMessage("XGPUS5 Invalid Max Allowed DrawDown Factor ...");
//
return result;
}
//
// Check Guard Actions ...
//
result =
xGPUS5CriticalDrawDownFactor > 0 &&
xGPUS5CriticalDrawDownFactor < 1 &&
xGPUS5MaxAllowedDrawDownFactor > 0 &&
xGPUS5MaxAllowedDrawDownFactor < 1;
if (!result)
{
//
LogMessage("XGPUS5 For Critical Drawdown, you have to Specify Max Drawdown also ...");
//
return result;
}
//
result = xGPUS5CriticalDrawDownFactor > 0 && xGPUS5CriticalDrawDownFactor < xGPUS5MaxAllowedDrawDownFactor;
if (!result)
{
//
LogMessage("XGPUS5 Critical Drawdown must Smaller than Max Drawdown ...");
//
return result;
}
//
if (xGPUS5CriticalDrawDownFactor > 0 && xGPUS5CriticalGuardAction == X_GUARD_DO_NOTHING)
{
LogMessage("XGPUS5 IMPORTANT you Specified Critical Drawdown, but there is no any Guard Action ...");
}
//
if (xGPUS5MaxAllowedDrawDownFactor > 0 && xGPUS5MaxAllowedGuardAction == X_GUARD_DO_NOTHING)
{
LogMessage("XGPUS5 IMPORTANT you Specified Max Allowed Drawdown, but there is no any Guard Action ...");
}
//
result = true;
//
return result;
}