Files
MQL5Data/Projects/XUSCHF5/Providers/x-saherelm.xuschf5.provider.inputs.lib.mq5
T

283 lines
8.8 KiB
Plaintext

///////////////////////////////////////////////////////////////
//
// SaherElm IT Center MQL5 XUSCHF5 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 "XUSCHF5 Provider";
//
// Commonly Used Configurations ...
input group "XUSCHF5 Common";
//
// Provider ...
input bool xUSCHF5EnableProvider = true; // Enable Provider
input int xUSCHF5NumberOfItemsPerTick = 30; // Number Of items Readed In Each Tick
//
// Alerts ...
input bool xUSCHF5EnableAlerts = true; // Enable Events Alert
input bool xUSCHF5EnableHourlyAlerts = false; // Send Alert on each new Hour
input bool xUSCHF5EnableDailyAlerts = false; // Send Alert on each new Day
input bool xUSCHF5EnableWeeklyAlerts = false; // Send Alert on each new Week
input bool xUSCHF5EnableMonthlyAlerts = true; // Send Alert on each new Month
//
// Reports ...
input bool xUSCHF5EnableDailyReports = false; // Send Report on each new Day
input bool xUSCHF5EnableWeeklyReports = false; // Send Report on each new Week
input bool xUSCHF5EnableMonthlyReports = true; // Send Report on each new Month
//
// Trader and Expert Specific Configurations ...
input group "XUSCHF5 Trader";
input int xUSCHF5MagicNumber = 16940562; // Trader MagicNumber
input int xUSCHF5Slippage = 10; // Trader Slippage
//
// Trades Management Configurations ...
input group "XUSCHF5 Trade Management";
input bool xUSCHF5AllowLongTrades = true; // Allow Long Trades
input bool xUSCHF5AllowShortTrades = true; // Allow Short Trades
//
// Risk Management Configurations ...
input group "XUSCHF5 Risk Management";
//
// Trade Count ...
input int xUSCHF5MaxAllowedTrades = 10; // Max Allowed Trades at Same Time
input ENUM_X_CROSS_SIGNAL_METHOD xUSCHF5CrossSignalsMethod = X_CROSS_SIGNAL_REGULAR; // Handle Cross Signals Method
//
// Max Allowed Trade Age ...
input int xUSCHF5MaxAllowedTradeAge = 1500; // Detect Long Time Trades
input ENUM_X_GUARD_ACTIONS xUSCHF5OldTradesAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_1; // What to do with Old Trades
//
// Trade Volume Specific Configurations ...
input double xUSCHF5StaticVolumeFactor = 0.0001; // Static Volume baesd on Balance
input ENUM_STATIC_VOLUME_METHODS xUSCHF5StaticVolumeMethod = X_STATIC_VOLUME_BASED_ON_BALANCE; // How to Calculate Static Volume
input double xUSCHF5VolumeMultiplier = 0; // Volume Increase Multiplier
input double xUSCHF5ApplyVolumeMultiplierFactor = 0; // Apply Volume Multiplier Rate based on Balance
input double xUSCHF5MaxSupportedVolumePerTradeFactor = 0; // Max Supported Volume Per Trade Factor based on Balance
input double xUSCHF5IncreasedMaxSupportedVolumeRate = 0; // Increase Max Supported Volume based on Balance
//
// Trade Profits ...
input double xUSCHF5MinRewardInPips = 6; // Minimum Reward Per Trade in Pips
input double xUSCHF5RiskFreeStepInPips = 0; // Make Trades Risk Free Steps in Pips
input double xUSCHF5RiskFreeRate = 0; // Volume Multiplier for Risk Free Trades
//
// Guard Riskable Money and Profits ...
input double xUSCHF5CriticalDrawDownFactor = 0.15; // Critical Allowed Drawdown Factor based on Balance
input ENUM_X_GUARD_ACTIONS xUSCHF5CriticalGuardAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_5; // Specify Guard Action on Critical Drawdown
input double xUSCHF5MaxAllowedDrawDownFactor = 0.20; // Max Allowed Drawdown Factor based on Balance
input ENUM_X_GUARD_ACTIONS xUSCHF5MaxAllowedGuardAction = X_GUARD_PARTIAL_CLOSE_MAX_IN_DD_10; // Specify Guard Action on Max Allowed Drawdown
input int xUSCHF5GuardStopoutFiredAfterTouches = 5; // Guard Stopout all Trades if Max Allowed Drawdown touched
//
// Account Conditions for Trading ...
input double xUSCHF5BalanceFactorForOpenTrades = 0.5; // Minimum Balance for Open Trades
input double xUSCHF5FreeMarginFactorForOpenTrades = 0.8; // Minimum Free Margin for Open Trades
//
// May be Used Later as Input Params ...
bool xUSCHF5UseVirtualTPSl = false; // Use Virtual TP SL
bool xUSCHF5EnableSignalAlerts = false; // Send Signal Alert
//
// Validate Inputs before Initialization ...
bool XUSCHF5ValidateInputs()
{
//
bool result = false;
//
// Implement Other Verifications ...
//
// Check Trading Availability ...
bool isTradeAvailable = xUSCHF5AllowLongTrades || xUSCHF5AllowShortTrades;
if (!isTradeAvailable)
{
LogMessage("XUSCHF5 => Warning: Trading disabled ...");
}
//
// Chekc Number of reading items per tick ...
result = xUSCHF5NumberOfItemsPerTick >= 5;
if (!result)
{
//
LogMessage("XUSCHF5 invalid Number of items Reading Per Tick ...");
//
return result;
}
//
// Check Max Allowed Trades Count ...
result = isTradeAvailable && xUSCHF5MaxAllowedTrades >= 1;
if (!result)
{
//
LogMessage("XUSCHF5 Number of Trades not valid ...");
//
return result;
}
//
// Check Free Margin ...
result =
isTradeAvailable &&
xUSCHF5FreeMarginFactorForOpenTrades > 0 &&
xUSCHF5FreeMarginFactorForOpenTrades < 1;
if (!result)
{
//
LogMessage("XUSCHF5 Invalid Free Margin ...");
//
return result;
}
//
// Check min Balance for Open Trades ...
result =
isTradeAvailable &&
xUSCHF5BalanceFactorForOpenTrades > 0 &&
xUSCHF5BalanceFactorForOpenTrades < 1;
if (!result)
{
//
LogMessage("XUSCHF5 Invalid Min Balance for Open Trades ...");
//
return result;
}
//
// Check Min Reward Per Trade ...
result = xUSCHF5MinRewardInPips > 0;
if (!result)
{
//
LogMessage("XUSCHF5 Invalid Min Reward Per Trade ...");
//
return result;
}
//
// Check Trades Volume ...
result = xUSCHF5StaticVolumeFactor > 0;
if (!result)
{
//
LogMessage("XUSCHF5 Invalid Static Volume ...");
//
return result;
}
//
// Check Volume Multiplier ...
result = xUSCHF5VolumeMultiplier >= 0;
if (!result)
{
//
LogMessage("XUSCHF5 Invalid Volume Multiplier ...");
//
return result;
}
//
result =
xUSCHF5CriticalDrawDownFactor == 0 || (xUSCHF5CriticalDrawDownFactor > 0 &&
xUSCHF5CriticalDrawDownFactor < 1);
if (!result)
{
//
LogMessage("XUSCHF5 Invalid Critical DrawDown Factor ...");
//
return result;
}
//
result =
xUSCHF5MaxAllowedDrawDownFactor == 0 || (xUSCHF5MaxAllowedDrawDownFactor > 0 &&
xUSCHF5MaxAllowedDrawDownFactor < 1);
if (!result)
{
//
LogMessage("XUSCHF5 Invalid Max Allowed DrawDown Factor ...");
//
return result;
}
//
// Check Guard Actions ...
//
result =
xUSCHF5CriticalDrawDownFactor > 0 &&
xUSCHF5CriticalDrawDownFactor < 1 &&
xUSCHF5MaxAllowedDrawDownFactor > 0 &&
xUSCHF5MaxAllowedDrawDownFactor < 1;
if (!result)
{
//
LogMessage("XUSCHF5 For Critical Drawdown, you have to Specify Max Drawdown also ...");
//
return result;
}
//
result = xUSCHF5CriticalDrawDownFactor > 0 && xUSCHF5CriticalDrawDownFactor < xUSCHF5MaxAllowedDrawDownFactor;
if (!result)
{
//
LogMessage("XUSCHF5 Critical Drawdown must Smaller than Max Drawdown ...");
//
return result;
}
//
if (xUSCHF5CriticalDrawDownFactor > 0 && xUSCHF5CriticalGuardAction == X_GUARD_DO_NOTHING)
{
LogMessage("XUSCHF5 IMPORTANT you Specified Critical Drawdown, but there is no any Guard Action ...");
}
//
if (xUSCHF5MaxAllowedDrawDownFactor > 0 && xUSCHF5MaxAllowedGuardAction == X_GUARD_DO_NOTHING)
{
LogMessage("XUSCHF5 IMPORTANT you Specified Max Allowed Drawdown, but there is no any Guard Action ...");
}
//
result = true;
//
return result;
}