Files
MQL5Data/Projects/XUSPY5/Providers/x-saherelm.xuspy5.provider.lib.mq5
T

1374 lines
29 KiB
Plaintext

////////////////////////////////////////////////////////////
//
// SaherElm IT Center MQL5 XUSPY5 Signal Provider Library
// --------------------------------------------------------
// Name: XUSPY5SignalProvider
// Description: XUSPY5 based signal provider ...
//
//
// 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
#define XUSPY5ProviderName "XUSPY5"
//
// START Inputs ...
//
#include "x-saherelm.xuspy5.provider.inputs.lib.mq5";
//
// END Inputs ...
//
//
// Include Common Library ...
#include "../Libraries/x-saherelm.common.lib.mq5"
//
// Include Logger Library ...
#include "../Libraries/x-saherelm.log.lib.mq5"
//
// Include Alert Library ...
#include "../Libraries/x-saherelm.alert.lib.mq5"
//
// Include Draw Library ...
#include "../Libraries/x-saherelm.draw.lib.mq5"
//
// Include Class Libraries ...
#include "../Classes/x-saherelm.class.lib.mq5"
//
// START Global Definitions: Variables, Properties and etc ...
//
//
XCGuard *xUSPY5Guard;
XCTrade *xUSPY5Trader;
XCReporter *xUSPY5Reporter;
XCCollector *xUSPY5Collector;
XCAccountInfo *xUSPY5AccountInfo;
XCVolumeManager *xUSPY5VolumeManager;
//
#include "x-saherelm.xuspy5.provider.indicators.lib.mq5"
//
// Controlling Variables ...
bool xUSPY5MEnableProvider = false;
bool xUSPY5MAllowLongTrades = false;
bool xUSPY5MAllowShortTrades = false;
//
double xUSPY5Deposit = 0;
double xUSPY5Balance = 0;
double xUSPY5MinReward = 0;
double xUSPY5FreeMargin = 0;
double xUSPY5BalanceForOpenTrades = 0;
double xUSPY5FreeMarginForOpenTrades = 0;
//
// Guard ...
double xUSPY5CriticalDrawDown = 0;
double xUSPY5MaxAllowedDrawDown = 0;
//
double xUSPY5MaxDrawUp = 0;
double xUSPY5MaxDrawDown = 0;
//
int NOT_ENOUGH_MONEY_ERROR = 4756;
const string XUSPY5_SUPPORT_ID = "SP";
//
// END Global Definitions: Variables, Properties and etc ...
//
//
// START Provided Functions ...
//
//
// Initial Library if required ...
bool XUSPY5InitSignalProviderLibrary()
{
//
bool result = false;
//
if (!xUSPY5EnableProvider)
{
return result;
}
//
// Controlling Variables ...
xUSPY5MEnableProvider = xUSPY5EnableProvider;
xUSPY5MAllowLongTrades = xUSPY5AllowLongTrades;
xUSPY5MAllowShortTrades = xUSPY5AllowShortTrades;
//
// Validate Inputs ...
result = XUSPY5ValidateInputs();
if (!result)
{
return result;
}
//
// Init Indicators ...
result = XUSPY5InitIndicators();
if (!result)
{
return result;
}
//
xUSPY5Reporter = new XCReporter();
xUSPY5Collector = new XCCollector();
xUSPY5AccountInfo = new XCAccountInfo();
//
// Calculate Account Deposit ...
xUSPY5Deposit = xUSPY5AccountInfo.GetInitialBalance();
//
// Prepare Min Reward ...
if (xUSPY5MinRewardInPips > 0)
{
xUSPY5MinReward = PipsToPrice(xUSPY5MinRewardInPips);
}
//
// Calculate Min Balance for Trades ...
if (xUSPY5BalanceFactorForOpenTrades > 0)
{
xUSPY5BalanceForOpenTrades = xUSPY5BalanceFactorForOpenTrades * xUSPY5Deposit;
}
//
// Claculate Min Free Marging for Trades ...
if (xUSPY5FreeMarginFactorForOpenTrades > 0)
{
xUSPY5FreeMarginForOpenTrades = xUSPY5FreeMarginFactorForOpenTrades * xUSPY5Deposit;
}
//
// Calculate Init Time Critical DrawDown Value ...
if (xUSPY5CriticalDrawDownFactor > 0)
{
xUSPY5CriticalDrawDown = xUSPY5CriticalDrawDownFactor * xUSPY5Deposit;
}
//
// Calculate Init Time Max Allowed DrawDown Value ...
if (xUSPY5MaxAllowedDrawDownFactor > 0)
{
xUSPY5MaxAllowedDrawDown = xUSPY5MaxAllowedDrawDownFactor * xUSPY5Deposit;
}
//
// Instant Volume Manager ...
xUSPY5VolumeManager = new XCVolumeManager(
xUSPY5StaticVolumeFactor,
xUSPY5StaticVolumeMethod,
xUSPY5VolumeMultiplier,
xUSPY5ApplyVolumeMultiplierFactor,
xUSPY5MaxSupportedVolumePerTradeFactor,
xUSPY5IncreasedMaxSupportedVolumeRate);
//
// Make XCTrader instance ...
xUSPY5Trader = new XCTrade(
XUSPY5ProviderName,
_Symbol,
xUSPY5Slippage,
xUSPY5MagicNumber,
xUSPY5UseVirtualTPSl,
xUSPY5MaxAllowedTrades,
xUSPY5FreeMarginForOpenTrades,
xUSPY5BalanceForOpenTrades);
//
// Instantiate Account Guard ...
xUSPY5Guard = new XCGuard(
//
// Old Trades ...
xUSPY5MaxAllowedTradeAge,
xUSPY5OldTradesAction,
//
// Critical DrawDown ...
xUSPY5CriticalDrawDownFactor,
xUSPY5CriticalGuardAction,
//
// Max Allowed DrawDown ...
xUSPY5MaxAllowedDrawDownFactor,
xUSPY5MaxAllowedGuardAction,
xUSPY5GuardStopoutFiredAfterTouches,
//
// xUSPY5GuardSupportMethod
X_SUPPORT_DO_NOTHING
//
);
//
// Reset Calculations Buffers and Variables ...
XUSPY5ResetCollectors();
//
XUSPY5UpdateReports();
//
result = true;
//
// Logging State ...
XUSPY5IssueInitializationSucceedAlert();
//
return result;
}
//
// DeInitial Library if required ...
void XUSPY5DeinitSignalProviderLibrary(const int reason)
{
//
// Release Handlers ...
XUSPY5ReleaseIndicators();
//
// Logging State ...
XUSPY5IssueDeinitializationSucceedAlert();
}
//
// this is a Globally Function which do all of
// checkings and positions handling ...
void XUSPY5SignalProviderHandleTick()
{
//
// Check Provider is Enable or Not ...
if (!xUSPY5MEnableProvider)
{
return;
}
//
XUSPY5SignalProviderDoControlState();
//
// Reading Indicator Buffers ...
XUSPY5HandleReadingBuffers();
if (xUSPY5CalculatedBars < xUSPY5MaxLengthOfInputs)
{
return;
}
//
// Handle Open Trades ...
XUSPY5HandleOpenTrades();
//
// Handle Close Trades ...
XUSPY5HandleCloseTrades();
//
// DrawDown and DrawUp ...
XUSPY5HandleCalculateDrawDownUp();
}
//
// Do Control Checks here ...
void XUSPY5SignalProviderDoControlState()
{
//
// Update account Balance ...
xUSPY5Balance = xUSPY5AccountInfo.GetBalance();
xUSPY5FreeMargin = xUSPY5AccountInfo.GetFreeMargin();
//
// Check Provider is Enable or Not ...
if (!xUSPY5MEnableProvider)
{
return;
}
//
// Protect Account by Guarding Maximum Drawdown ...
// TODO: add Guard Result here ...
string guardMessage = "";
XGuardHandlerResult guardHandlerResult;
bool isGuarded = xUSPY5Guard.Guard(
guardHandlerResult,
guardMessage,
xUSPY5Trader,
_Period);
if (isGuarded)
{
//
// Criticals ...
int criticalsCount = ArraySize(guardHandlerResult.criticals);
if (criticalsCount > 0)
{
//
for (int i = 0; i < criticalsCount; i++)
{
//
XSignal iSignal = guardHandlerResult.criticals[i];
//
XUSPY5OnGuard(
iSignal,
X_GUARDED_CRITICAL,
guardMessage);
}
}
//
// Maxes ...
int maxesCount = ArraySize(guardHandlerResult.maxes);
if (maxesCount > 0)
{
//
for (int i = 0; i < maxesCount; i++)
{
//
XSignal iSignal = guardHandlerResult.maxes[i];
//
XUSPY5OnGuard(
iSignal,
X_GUARDED_MAX,
guardMessage,
guardHandlerResult.isStopOut);
}
}
//
// Olds ...
int oldsCount = ArraySize(guardHandlerResult.olds);
if (oldsCount > 0)
{
//
for (int i = 0; i < oldsCount; i++)
{
//
XSignal iSignal = guardHandlerResult.olds[i];
//
XUSPY5OnGuard(
iSignal,
X_GUARDED_OLD,
guardMessage);
}
}
}
//
// Signal Protection ...
XSignal protectSupports[];
bool isSupported = xUSPY5Guard.ProtectSignals(
protectSupports,
xUSPY5Trader);
if (isSupported)
{
//
LogMessage("Guard do Support Trdae ...");
}
//
// Handling Signals ...
XTraderHandlerResult signalHandlerResult;
xUSPY5Trader.HandleSignals(
signalHandlerResult,
false // Ignore Risk Free Trdaes
);
//
// Handle Sl Reports ...
int handledSLsCount = ArraySize(signalHandlerResult.sl);
if (handledSLsCount > 0)
{
//
for (int i = 0; i < handledSLsCount; i++)
{
//
XSignal iSignal = signalHandlerResult.sl[i];
XUSPY5OnSL(iSignal);
}
}
//
// Handle TP Reports ...
int handledTPsCount = ArraySize(signalHandlerResult.tp);
if (handledTPsCount > 0)
{
//
for (int i = 0; i < handledTPsCount; i++)
{
//
XSignal iSignal = signalHandlerResult.tp[i];
XUSPY5OnTP(iSignal);
}
}
//
// Handle RFs as TP Reports ...
int handledRFsCount = ArraySize(signalHandlerResult.rf);
if (handledRFsCount > 0)
{
//
for (int i = 0; i < handledRFsCount; i++)
{
//
XSignal iSignal = signalHandlerResult.rf[i];
XUSPY5OnRF(iSignal);
}
}
}
//
// Handle Trades when OnTrade Event Hnadler Calls ...
void XUSPY5SignalProviderHandleTrade()
{
//
// Check Provider Enabled ...
if (!xUSPY5MEnableProvider)
{
return;
}
//
// Handle OnTrade Event ...
XOnTradeHandlerResult result = {};
xUSPY5Trader.HandleOnTradeEvent(
result);
//
// Detected TP or SL ...
if (result.hasNewDeal)
{
//
XDeal last = xUSPY5Trader.GetLastDeal();
//
if (last.reason == DEAL_REASON_SL)
{
xUSPY5Reporter.AddTradeSLInReports();
}
else if (last.reason == DEAL_REASON_TP)
{
xUSPY5Reporter.AddTradeTPInReports();
}
}
}
//
// Handle Open Trades ...
void XUSPY5HandleOpenTrades()
{
//
// Check Can Trade ...
bool canTrade = xUSPY5MAllowLongTrades || xUSPY5MAllowShortTrades;
if (!canTrade)
{
return;
}
//
// Check Max Open Trades ...
int openSignals = xUSPY5Trader.Count();
bool canOpenPositions = openSignals < xUSPY5MaxAllowedTrades;
if (!canOpenPositions)
{
return;
}
//
// Check Signals Exists ...
XProvidedSignal longSignalInfo;
XProvidedSignal shortSignalInfo;
bool hasLongSignal = XUSPY5CanOpenLongTrade(longSignalInfo);
bool hasShortSignal = XUSPY5CanOpenShortTrade(shortSignalInfo);
if (!hasLongSignal && !hasShortSignal)
{
return;
}
//
// Update Reports ...
XUSPY5UpdateReports();
//
xUSPY5WaitUntilNextCandle = true;
//
// Open Long Trades ...
if (
//
hasLongSignal &&
xUSPY5MAllowLongTrades)
{
//
bool isOpened = XUSPY5OpenLongPosition(longSignalInfo);
}
//
// Open Short Trades ...
if (
//
hasShortSignal &&
xUSPY5MAllowShortTrades)
{
//
bool isOpened = XUSPY5OpenShortPosition(shortSignalInfo);
}
}
//
// Handle Close Trades ...
void XUSPY5HandleCloseTrades()
{
//
// Force Close Long Trades ...
bool isClosedLongTrades = false;
bool canCloseLongTrades = XUSPY5CanCloseLongTrade();
if (xUSPY5MAllowLongTrades && canCloseLongTrades)
{
//
ENUM_X_SIGNAL_TYPE type = X_SIGNAL_LONG;
//
XSignal closed[];
xUSPY5Trader.CloseSignals(
closed,
type);
//
int closedTradesCount = ArraySize(closed);
isClosedLongTrades = closedTradesCount > 0;
if (isClosedLongTrades)
{
//
for (int i = 0; i < closedTradesCount; i++)
{
//
XSignal iSignal = closed[i];
XUSPY5OnFC(iSignal);
}
}
}
//
// Force Close Short Trades ...
bool isClosedShortTrades = false;
bool canCloseShortTrades = XUSPY5CanCloseShortTrade();
if (xUSPY5MAllowShortTrades && canCloseShortTrades)
{
//
ENUM_X_SIGNAL_TYPE type = X_SIGNAL_SHORT;
//
XSignal closed[];
xUSPY5Trader.CloseSignals(
closed,
type);
//
int closedTradesCount = ArraySize(closed);
isClosedShortTrades = closedTradesCount > 0;
if (isClosedShortTrades)
{
//
for (int i = 0; i < closedTradesCount; i++)
{
//
XSignal iSignal = closed[i];
XUSPY5OnFC(iSignal);
}
}
}
}
//
// Open Long Position ...
bool XUSPY5OpenLongPosition(
XProvidedSignal &info // Retrieve Signal Additional Info on this Object
)
{
//
bool result = false;
//
// Calculate Required Data for Position ...
double entry = GetEntry(_Symbol, X_SIGNAL_LONG);
double sl = info.sl > 0 ? info.sl : 0;
// entry - (200 * _Point);
// info.sl > 0 ? info.sl : 0;
double tp = info.tp > 0 ? info.tp : entry + xUSPY5MinReward;
double riskFreeRate = xUSPY5RiskFreeRate;
double riskFreeStep = xUSPY5RiskFreeStepInPips;
double volume = XUSPY5CalculateVolume(ArraySize(info.signallers));
//
XSignal signal = {};
signal = xUSPY5Trader.GenerateSignal(
X_SIGNAL_LONG,
tp,
sl,
volume,
riskFreeStep,
riskFreeRate);
bool isValidSignal = IsValid(
signal,
xUSPY5MagicNumber);
if (!isValidSignal)
{
return result;
}
//
int signalsCount = xUSPY5Trader.Count();
bool isCross = signalsCount >= 1;
if (isCross)
{
//
// Handle Cross Signals ...
XUSPY5HnadleCrossSignal(signal);
}
//
// Retrieve Can Execute Signal or not ...
bool canExecuteSignal =
!isCross
//
||
//
(
//
isCross &&
xUSPY5CrossSignalsMethod != X_CROSS_SIGNAL_DO_NOTHING
//
);
if (!canExecuteSignal)
{
return result;
}
//
// Execute Signal ...
ENUM_EXECUTION_SIGNAL_RESULT executionResult = xUSPY5Trader.ExecuteSignal(
signal,
false, // Ignore Number of Trades ...
true // Check Account Conditions ...
);
result = executionResult == X_TRADER_SUCCEED_EXECUTION;
if (result)
{
//
// Update Reports ...
string providers[];
ArrayCopy(
providers,
info.signallers
);
//
XSignal tSignal = xUSPY5Trader.GetSignal(signal.ticket);
//
XUSPY5OnSignal(
tSignal,
providers);
}
else
{
XUSPY5IssueSignalExecutionError(executionResult);
}
//
return result;
}
//
// Open Short Position ...
bool XUSPY5OpenShortPosition(
XProvidedSignal &info // Retrieve Signal Additional Info on this Object
)
{
//
bool result = false;
//
// Calculate Required Data for Position ...
double entry = GetEntry(_Symbol, X_SIGNAL_SHORT);
double sl = info.sl > 0 ? info.sl : 0;
// entry + (200 * _Point);
// info.sl > 0 ? info.sl : 0;
double tp = info.tp > 0 ? info.tp : entry - xUSPY5MinReward;
double riskFreeRate = xUSPY5RiskFreeRate;
double riskFreeStep = xUSPY5RiskFreeStepInPips;
double volume = XUSPY5CalculateVolume(ArraySize(info.signallers));
//
XSignal signal = {};
signal = xUSPY5Trader.GenerateSignal(
X_SIGNAL_SHORT,
tp,
sl,
volume,
riskFreeStep,
riskFreeRate);
bool isValidSignal = IsValid(
signal,
xUSPY5MagicNumber);
if (!isValidSignal)
{
return result;
}
//
int signalsCount = xUSPY5Trader.Count();
bool isCross = signalsCount >= 1;
if (isCross)
{
//
// Handle Cross Signals ...
XUSPY5HnadleCrossSignal(signal);
}
//
// Retrieve Can Execute Signal or not ...
bool canExecuteSignal =
!isCross
//
||
//
(
//
isCross &&
xUSPY5CrossSignalsMethod != X_CROSS_SIGNAL_DO_NOTHING
//
);
if (!canExecuteSignal)
{
return result;
}
//
// Execute Signal ...
ENUM_EXECUTION_SIGNAL_RESULT executionResult = xUSPY5Trader.ExecuteSignal(
signal,
false, // Ignore Number of Trades ...
true // Check Account Conditions ...
);
result = executionResult == X_TRADER_SUCCEED_EXECUTION;
if (result)
{
string providers[];
ArrayCopy(
providers,
info.signallers
);
//
XSignal tSignal = xUSPY5Trader.GetSignal(signal.ticket);
//
XUSPY5OnSignal(
tSignal,
providers);
}
else
{
XUSPY5IssueSignalExecutionError(executionResult);
}
//
return result;
}
//
// Apply Cross Signal Actions ...
void XUSPY5HnadleCrossSignal(
XSignal &signal // Specified Signal ...
)
{
//
// Check Cross Signal Handling Enabled ...
if (xUSPY5CrossSignalsMethod == X_CROSS_SIGNAL_DO_NOTHING)
{
return;
}
//
// First We have to Change Cross Signals Comment ...
string comment = xUSPY5Trader.GenerateSignalComment(
signal,
true);
//
signal.comment = comment;
//
// If Every thing is Regular, prevent any changes here ...
if (xUSPY5CrossSignalsMethod == X_CROSS_SIGNAL_REGULAR)
{
return;
}
//
// Retrieve Max in Drawdown Signal ...
XSignal maxInDDSignal = xUSPY5Trader.GetMaxInDrawdownSignal();
//
// Validate Signal ...
bool isValidSignal =
maxInDDSignal.ticket > 0 &&
maxInDDSignal.symbol == signal.symbol &&
IsValid(maxInDDSignal, xUSPY5MagicNumber);
if (!isValidSignal)
{
return;
}
//
double volume = signal.volume;
bool isDirectional = maxInDDSignal.type == signal.type;
//
// Prevent any changes on Regular Conditions ...
bool isRegular =
isDirectional
? (
//
xUSPY5CrossSignalsMethod == X_CROSS_SIGNAL_DIRECTION_REGULAR ||
xUSPY5CrossSignalsMethod == X_CROSS_SIGNAL_DIRECTION_REGULAR_INDIRECTION_IMPORTANT
//
)
: (
//
xUSPY5CrossSignalsMethod == X_CROSS_SIGNAL_INDIRECTION_REGULAR ||
xUSPY5CrossSignalsMethod == X_CROSS_SIGNAL_DIRECTION_IMPORTANT_INDIRECTION_REGULAR
//
);
if (isRegular)
{
return;
}
//
// Important Act needs to Multiply volume by 2 ...
volume *= 2;
//
// Set Volume of signal ...
signal.volume = volume;
}
//
// Calculate Usefull data ...
void XUSPY5HandleCalculateDrawDownUp()
{
//
XSignal signals[];
xUSPY5Trader.GetSignals(signals);
int signalsCount = ArraySize(signals);
if (signalsCount <= 0)
{
return;
}
//
double profit = 0;
double volume = 0;
XCollector collector = {};
double maxAllowedVolume = xUSPY5VolumeManager.GetMaxAllowedVolume();
for (int i = 0; i < signalsCount; i++)
{
//
XSignal iSignal = signals[i];
//
profit += iSignal.profit;
//
volume =
volume == 0 ||
volume < iSignal.volume
? iSignal.volume
: volume;
}
//
if (profit < 0)
{
//
xUSPY5MaxDrawDown =
xUSPY5MaxDrawDown == 0 ||
xUSPY5MaxDrawDown > MathAbs(profit)
? MathAbs(profit)
: xUSPY5MaxDrawDown;
//
// Update Buffers ...
datetime time = iTime(_Symbol, _Period, 0);
//
// Calculate Max Allowed Drawdown ...
//
collector.time = time;
collector.volume = volume;
collector.maxDrawDown = xUSPY5MaxDrawDown;
collector.maxAllowedVolume = maxAllowedVolume;
collector.minBalanceForOpenTrade = xUSPY5Trader.GetMinBalanceForOpenTrades();
}
else
{
//
xUSPY5MaxDrawUp =
xUSPY5MaxDrawUp == 0 ||
xUSPY5MaxDrawUp < profit
? profit
: xUSPY5MaxDrawUp;
}
//
// Update Collector ...
xUSPY5Collector.Add(collector);
//
// Update Reports ...
xUSPY5Reporter.UpdateMaxDrawUpInReports(xUSPY5MaxDrawUp);
xUSPY5Reporter.UpdateMaxDrawDownInReports(xUSPY5MaxDrawDown);
xUSPY5Reporter.UpdateMaxSameTimeTradesInReports(signalsCount);
}
//
// START Event Handlers ...
//
//
// Runs When a Signal Successfully Executed ...
void XUSPY5OnSignal(
XSignal &signal, // Specified Signal
string &providers[] // Signal Providers
)
{
//
// Issue Propper Alert ...
XUSPY5IssueSignalExecutionAlert(
signal,
providers);
//
// Add Signal To Supports on Guard ...
xUSPY5Guard.AddSupport(signal);
//
// Update Reports ...
xUSPY5Reporter.AddSignalToReports(
signal,
providers);
}
//
// Runs when a Position Got Take Profit ...
void XUSPY5OnTP(
XSignal &signal // Specified Signal
)
{
//
// Issue Propper Alert ...
XUSPY5IssueTPAlert(signal);
//
// Remove Signal From Guard Protector ...
xUSPY5Guard.Remove(signal.ticket);
xUSPY5Guard.RemoveSupport(signal.ticket);
//
// Update Reports ...
xUSPY5Reporter.AddTradeTPInReports();
XUSPY5UpdateReports();
}
//
// Runs when a Position Got Stop Loss ...
void XUSPY5OnSL(
XSignal &signal // Specified Signal
)
{
//
// Issue Propper Alert ...
XUSPY5IssueSLAlert(signal);
//
// Remove Signal From Guard Protector ...
xUSPY5Guard.Remove(signal.ticket);
xUSPY5Guard.RemoveSupport(signal.ticket);
//
// Update Reports ...
xUSPY5Reporter.AddTradeSLInReports();
XUSPY5UpdateReports();
}
//
// Runs when a Position Risk Free ...
void XUSPY5OnRF(
XSignal &signal // Specified Signal
)
{
//
// Issue Propper Alert ...
XUSPY5IssueRFAlert(signal);
//
// Remove Signal From Guard Protector ...
// since RiskFree Signals has SL ...
xUSPY5Guard.Remove(signal.ticket);
xUSPY5Guard.RemoveSupport(signal.ticket);
//
// Update Reports ...
xUSPY5Reporter.AddTradeSLInReports();
XUSPY5UpdateReports();
}
//
// Runs when a Position Force Closed ...
void XUSPY5OnFC(
XSignal &signal // Specified Signal
)
{
//
// Issue Propper Alert ...
XUSPY5IssueFCAlert(signal);
//
// Remove Signal From Guard Protector ...
xUSPY5Guard.Remove(signal.ticket);
xUSPY5Guard.RemoveSupport(signal.ticket);
//
// Update Reports ...
xUSPY5Reporter.AddTradeSLInReports();
XUSPY5UpdateReports();
}
//
// Runs when a Position Guarded ...
void XUSPY5OnGuard(
XSignal &signal, // Specified Signal
ENUM_X_GUARD_REASONS reason, // Reason of Guard Applied
string message, // Guard Returned Message
bool isStopOut = false // Specified StopOut Fired or not
)
{
//
// Chekc StopOut ...
if (isStopOut)
{
//
LogMessage(message);
//
xUSPY5MEnableProvider = false;
}
//
// Issue Propper Alert ...
XUSPY5IssueGuardAlert(signal, reason, isStopOut);
//
// Update Reports ...
xUSPY5Reporter.AddTradeSLInReports();
XUSPY5UpdateReports();
}
//
// END Event Handlers ...
//
//
// END Provided Functions ...
//
//
// START Private Functions ...
//
//
// START Volume Baseed Functions ...
//
//
// Calculating Volume for Tradings ...
double XUSPY5CalculateVolume(
double forceMultiplier = 0 // some times we get more than one signal at the same time, here we increase volume using this ...
)
{
//
// Check Open Trades ...
int openSignals = xUSPY5Trader.Count();
//
double result = xUSPY5VolumeManager.CalculateVolume(
openSignals,
_Symbol);
//
result *= forceMultiplier;
//
// Normalize Volume ...
result = NormalizeVolume(result, _Symbol, 2);
//
return result;
}
//
// END Volume Baseed Functions ...
//
//
// START Report/Collect and Guard Functions ...
//
//
// Update Report Info ...
void XUSPY5UpdateReports()
{
//
double staticVolume = xUSPY5VolumeManager.GetStaticVolume();
string staticVolumeCalculationMethod = EnumToString(xUSPY5StaticVolumeMethod);
double maxAllowedVolume = xUSPY5VolumeManager.GetMaxAllowedVolume();
double volumeIncreaseMultiplier = xUSPY5VolumeManager.GetVolumeMultiplier();
double balanceGowingToApplyMultiplier = xUSPY5VolumeManager.GetIncreaseMultiplierBalance();
double balanceGrowingToIncreaseMaxAllowedVolume = xUSPY5VolumeManager.GetIncreaseMaxAllowedVolumeBalance();
//
// Update Reports Volume Info ...
xUSPY5Reporter.UpdateReportsVolumeInfo(
staticVolume,
staticVolumeCalculationMethod,
maxAllowedVolume,
volumeIncreaseMultiplier,
balanceGowingToApplyMultiplier,
balanceGrowingToIncreaseMaxAllowedVolume);
//
// Calculate Max Allowed Drawdown ...
double minBalanceForTradeBasedOnBalance = xUSPY5Trader.GetMinBalanceForOpenTrades();
xUSPY5Reporter.UpdateMinBalanceForOpenTradesInReports(minBalanceForTradeBasedOnBalance);
}
//
// Reset XUSPY5 Info Buffers ...
void XUSPY5ResetCollectors()
{
//
// Reset Calculations Buffers and Variables ...
xUSPY5MaxDrawUp = 0;
xUSPY5MaxDrawDown = 0;
//
xUSPY5Trader.Reset();
xUSPY5Reporter.Reset();
xUSPY5Collector.Reset();
xUSPY5VolumeManager.ResetForceVolumeMultiplier();
}
//
// END Report/Collect and Guard Functions ...
//
//
// START Alert Functions ...
//
//
// Send Alert ...
void XUSPY5IssueAlert(string message)
{
//
// Validate Args ...
if (StringLen(message) <= 0)
{
return;
}
//
if (xUSPY5EnableAlerts)
{
SendAlert(message);
}
else
{
LogMessage(message);
}
}
//
// Send Take Profit Alert on Specific Signal ...
void XUSPY5IssueTPAlert(
XSignal &signal // Specified Signal
)
{
//
string message = "";
//
message = xUSPY5Trader.GenerateSignalTPComment(signal);
//
XUSPY5IssueAlert(message);
}
//
// Send Stop Loss Alert on Specific Signal ...
void XUSPY5IssueSLAlert(
XSignal &signal // Specified Signal
)
{
//
string message = "";
//
message = xUSPY5Trader.GenerateSignalSLComment(signal);
//
XUSPY5IssueAlert(message);
}
//
// Send Force Close Alert on Specific Signal ...
void XUSPY5IssueFCAlert(
XSignal &signal // Specified Signal
)
{
//
string message = "";
//
message = xUSPY5Trader.GenerateSignalForceCloseComment(signal);
//
XUSPY5IssueAlert(message);
}
//
// Send Risk Free Alert on Specific Signal ...
void XUSPY5IssueRFAlert(
XSignal &signal // Specified Signal
)
{
//
string message = "";
//
message = xUSPY5Trader.GenerateSignalRFComment(signal, 0);
//
XUSPY5IssueAlert(message);
}
//
// Send Guard Alert on Specific Signal ...
void XUSPY5IssueGuardAlert(
XSignal &signal, // Specified Signal
ENUM_X_GUARD_REASONS reason, // Specified Guard Reason
bool isStopOut = false // Specified StopOut Fired or not
)
{
//
string message = "";
//
message = xUSPY5Guard.GenerateGuardedSignalComment(
signal,
reason);
//
XUSPY5IssueAlert(message);
}
//
// Send Initialization Succeed Alert ...
void XUSPY5IssueInitializationSucceedAlert()
{
//
string message = "Initializion of (" + XUSPY5ProviderName + " Provider" + " _ " + _Symbol + " _ " + EnumToString(_Period) + ") Succeeded ...";
XUSPY5IssueAlert(message);
}
//
// Send De Initialization Succeed Alert ...
void XUSPY5IssueDeinitializationSucceedAlert()
{
//
string message = "De Initializion of (" + XUSPY5ProviderName + " Provider" + ") Succeeded ...";
XUSPY5IssueAlert(message);
}
//
// Send Signal Successfully Execution Alert ...
void XUSPY5IssueSignalExecutionAlert(
XSignal &signal, // Specified Signal
string &providers[] // Signal Providers
)
{
//
string message = xUSPY5Trader.ToString(signal);
//
string providersMsg = ToString(providers);
if (StringLen(providersMsg) > 0)
{
message += ", Providers: " + providersMsg;
}
//
XUSPY5IssueAlert(message);
}
//
// Send Signal Execution Alert ...
void XUSPY5IssueSignalExecutionError(int error)
{
//
string message = GetSignalExecutionError(error);
if (StringLen(message) == 0)
{
return;
}
//
XUSPY5IssueAlert(message);
}
//
// END Alert Functions ...
//
//
// END Private Functions ...
//