539 lines
34 KiB
JavaScript
539 lines
34 KiB
JavaScript
exports.newTradingSimulation = function (processIndex, logger, tradingEngineModule, UTILITIES) {
|
|
/*
|
|
This Module represents the trading simulacion. Escentially a loop through a set of candles and
|
|
the execution at each loop cycle of the Trading System Protocol.
|
|
*/
|
|
const FULL_LOG = true
|
|
const MODULE_NAME = 'Trading Simulation -> ' + TS.projects.superalgos.globals.taskConstants.TASK_NODE.bot.processes[processIndex].session.name
|
|
|
|
let thisObject = {
|
|
finalize: finalize,
|
|
runSimulation: runSimulation
|
|
}
|
|
|
|
let utilities = UTILITIES.newCloudUtilities(logger)
|
|
|
|
return thisObject
|
|
|
|
function finalize() {
|
|
thisObject = undefined
|
|
}
|
|
|
|
async function runSimulation(
|
|
chart,
|
|
outputDatasetsMap,
|
|
writeFiles,
|
|
) {
|
|
try {
|
|
|
|
let tradingSystem = TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).SIMULATION_STATE.tradingSystem
|
|
let tradingEngine = TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).SIMULATION_STATE.tradingEngine
|
|
let sessionParameters = TS.projects.superalgos.globals.processConstants.CONSTANTS_BY_PROCESS_INDEX_MAP.get(processIndex).SESSION_NODE.tradingParameters
|
|
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> initialDatetime = ' + sessionParameters.timeRange.config.initialDatetime) }
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> finalDatetime = ' + sessionParameters.timeRange.config.finalDatetime) }
|
|
|
|
/* These are the Modules we will need to run the Simulation */
|
|
const TRADING_RECORDS_MODULE = require('./TradingRecords.js')
|
|
let tradingRecordsModule = TRADING_RECORDS_MODULE.newTradingRecords(processIndex, logger)
|
|
tradingRecordsModule.initialize(outputDatasetsMap)
|
|
|
|
const TRADING_SYSTEM_MODULE = require('./TradingSystem.js')
|
|
let tradingSystemModule = TRADING_SYSTEM_MODULE.newTradingSystem(processIndex, logger, tradingEngineModule)
|
|
tradingSystemModule.initialize()
|
|
|
|
const TRADING_EPISODE_MODULE = require('./TradingEpisode.js')
|
|
let tradingEpisodeModule = TRADING_EPISODE_MODULE.newTradingEpisode(processIndex, logger, tradingEngineModule)
|
|
tradingEpisodeModule.initialize()
|
|
|
|
/* Setting up the candles array: The whole simulation is based on the array of candles at the time-frame defined at the session parameters. */
|
|
let propertyName = 'at' + sessionParameters.timeFrame.config.label.replace('-', '')
|
|
let candles = chart[propertyName].candles
|
|
|
|
/* Variables needed for heartbeat functionality */
|
|
let heartBeatDate
|
|
let previousHeartBeatDate
|
|
/*
|
|
Estimation of the Initial Candle to Process in this Run.
|
|
*/
|
|
let initialCandle
|
|
if (TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).IS_SESSION_FIRST_LOOP === true && TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).IS_SESSION_RESUMING === false) {
|
|
/* Estimate Initial Candle based on the timeRage configured for the session. */
|
|
let firstEnd = candles[0].end
|
|
let targetEnd = sessionParameters.timeRange.config.initialDatetime
|
|
let diff = targetEnd - firstEnd
|
|
let amount = diff / sessionParameters.timeFrame.config.value
|
|
|
|
initialCandle = Math.trunc(amount)
|
|
if (initialCandle < 0) { initialCandle = 0 }
|
|
if (initialCandle > candles.length - 1) {
|
|
/*
|
|
This will happen when the sessionParameters.timeRange.config.initialDatetime is beyond the last candle available,
|
|
meaning that the dataSet needs to be updated with more up-to-date data.
|
|
*/
|
|
TS.projects.superalgos.functionLibraries.sessionFunctions.stopSession(processIndex, 'Data is not up-to-date enough. Please start the Masters Data Mining Operation.')
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[IMPORTANT] runSimulation -> Data is not up-to-date enough. Stopping the Session now. ') }
|
|
return
|
|
}
|
|
} else {
|
|
|
|
/*
|
|
In this case we already have at the last candle index the next candle to be
|
|
processed. We will just continue with this candle.
|
|
*/
|
|
initialCandle = tradingEngine.current.episode.candle.index.value
|
|
}
|
|
/*
|
|
Main Simulation Loop
|
|
*/
|
|
/* We are going to use this to exit the loop if needed. */
|
|
let breakLoop = false
|
|
|
|
/*
|
|
We will assume that we are at the head of the market here. We do this
|
|
because the loop could be empty and no validation is going to run. If the
|
|
loop is not empty, then the lascCandle() check will override this value
|
|
depending on if we really are at the head of the market or not.
|
|
*/
|
|
tradingEngine.current.episode.headOfTheMarket.value = true
|
|
/*
|
|
This is the main simulation loop. It will go through the initial candle
|
|
until one less than the last candle available. We will never process the last
|
|
candle available since it is not considered a closed candle, but a candle
|
|
that still can change. So effectively will be processing all closed candles.
|
|
*/
|
|
for (let i = initialCandle; i < candles.length - 1; i++) {
|
|
tradingEngine.current.episode.candle.index.value = i
|
|
|
|
/* This is the current candle the Simulation is working at. */
|
|
let candle = candles[tradingEngine.current.episode.candle.index.value]
|
|
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> loop -> Candle Begin @ ' + (new Date(candle.begin)).toLocaleString()) }
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> loop -> Candle End @ ' + (new Date(candle.end)).toLocaleString()) }
|
|
|
|
tradingEngineModule.setCurrentCandle(candle) // We move the current candle we are standing at, to the trading engine data structure to make it available to anyone, including conditions and formulas.
|
|
|
|
/* We emit a heart beat so that the UI can now where we are at the overal process.*/
|
|
heartBeat()
|
|
|
|
/* Opening the Episode, if needed. */
|
|
tradingEpisodeModule.openEpisode()
|
|
|
|
if (checkInitialDatetime() === false) {
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> loop -> Candle Before the Initia Date Time @ ' + (new Date(candle.begin)).toLocaleString()) }
|
|
continue
|
|
}
|
|
|
|
positionChartAtCurrentCandle()
|
|
|
|
/* The chart was recalculated based on the current candle. */
|
|
tradingSystemModule.updateChart(chart)
|
|
|
|
/*
|
|
Do the stuff needed previous to the run like
|
|
Episode Counters and Statistics update. Mantaince is done
|
|
once per simulation candle.
|
|
*/
|
|
tradingSystemModule.mantain()
|
|
tradingEpisodeModule.mantain()
|
|
tradingEngineModule.mantain()
|
|
|
|
/*
|
|
Run the first cycle of the Trading System. In this first cycle we
|
|
give some room so that orders can be canceled or filled and we can
|
|
write those records into the output memory. During this cycle new
|
|
orders can not be created, since otherwise the could be cancelled at
|
|
the second cycle without spending real time at the order book.
|
|
*/
|
|
tradingEngineModule.setCurrentCycle('First')
|
|
await runCycle()
|
|
|
|
/*
|
|
We check if we need to stop before appending the records so that the stop
|
|
reason is also propery recorded. Note also that we check this after the first
|
|
cycle, where orders have not been submitted to the exchange yet, but we
|
|
had the chance to check for the status of placed orders or even cancel
|
|
the ones that needed cancellation.
|
|
*/
|
|
checkIfWeNeedToStopBetweenCycles()
|
|
|
|
/* Add new records to the process output */
|
|
tradingRecordsModule.appendRecords()
|
|
|
|
if (breakLoop === true) { break }
|
|
/*
|
|
Run the second cycle of the Trading System. During this second run
|
|
some new orders might be created at slots freed up during the first
|
|
run. This allows for example for a Limit Order to be cancelled during the
|
|
first run, and the same Limit Order definition to spawn a new order
|
|
without the need to wait until the next candle. Orders can not be cancelled
|
|
during the second cycle.
|
|
*/
|
|
tradingEngineModule.setCurrentCycle('Second')
|
|
await runCycle()
|
|
|
|
checkIfWeNeedToStopAfterBothCycles()
|
|
|
|
/* Add new records to the process output */
|
|
tradingRecordsModule.appendRecords()
|
|
|
|
if (breakLoop === true) { break }
|
|
|
|
async function runCycle() {
|
|
/* Reset Data Structures */
|
|
tradingSystemModule.reset()
|
|
tradingEpisodeModule.reset()
|
|
tradingEngineModule.reset()
|
|
|
|
let infoMessage = 'Processing candle # ' + tradingEngine.current.episode.candle.index.value + ' @ the ' + tradingEngine.current.episode.cycle.value + ' cycle.'
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> loop -> ' + infoMessage) }
|
|
tradingSystem.infos.push([tradingSystem.id, infoMessage])
|
|
|
|
await tradingSystemModule.run()
|
|
}
|
|
|
|
function checkIfWeNeedToStopBetweenCycles() {
|
|
if (TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).IS_SESSION_STOPPING === true) {
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> controlLoop -> We are going to stop here bacause we were requested to stop processing this session.') }
|
|
updateEpisode('Session Stopped')
|
|
breakLoop = true
|
|
return
|
|
}
|
|
|
|
if (TS.projects.superalgos.globals.taskVariables.IS_TASK_STOPPING === true) {
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> controlLoop -> We are going to stop here bacause we were requested to stop processing this task.') }
|
|
updateEpisode('Task Stopped')
|
|
breakLoop = true
|
|
return
|
|
}
|
|
|
|
if (checkFinalDatetime() === false) {
|
|
closeEpisode('Final Datetime Reached')
|
|
breakLoop = true
|
|
TS.projects.superalgos.functionLibraries.sessionFunctions.stopSession(processIndex, 'Final Datetime Reached')
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[IMPORTANT] runSimulation -> Final Datetime Reached. Stopping the Session now. ') }
|
|
return
|
|
}
|
|
|
|
if (checkMinimunAndMaximunBalance() === false) {
|
|
closeEpisode('Min or Max Balance Reached')
|
|
breakLoop = true
|
|
TS.projects.superalgos.functionLibraries.sessionFunctions.stopSession(processIndex, 'Min or Max Balance Reached')
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[IMPORTANT] runSimulation -> Min or Max Balance Reached. Stopping the Session now. ') }
|
|
return
|
|
}
|
|
}
|
|
|
|
function checkIfWeNeedToStopAfterBothCycles() {
|
|
if (checkNextCandle() === false) {
|
|
updateEpisode('All Candles Processed')
|
|
breakLoop = true
|
|
return
|
|
}
|
|
}
|
|
}
|
|
|
|
tradingSystemModule.finalize()
|
|
tradingRecordsModule.finalize()
|
|
tradingEpisodeModule.finalize()
|
|
|
|
tradingSystemModule = undefined
|
|
tradingRecordsModule = undefined
|
|
tradingEpisodeModule = undefined
|
|
|
|
await writeFiles()
|
|
|
|
function closeEpisode(exitType) {
|
|
tradingEpisodeModule.updateExitType(exitType)
|
|
tradingEpisodeModule.closeEpisode()
|
|
}
|
|
|
|
function updateEpisode(exitType) {
|
|
tradingEpisodeModule.updateExitType(exitType)
|
|
}
|
|
|
|
function heartBeat() {
|
|
let hartbeatText = ''
|
|
if (sessionParameters.heartbeats !== undefined) {
|
|
if (sessionParameters.heartbeats.config.date === true || sessionParameters.heartbeats.config.candleIndex === true) {
|
|
/* We will produce a simulation level heartbeat in order to inform the user this is running. */
|
|
|
|
heartBeatDate = new Date(Math.trunc(tradingEngine.current.episode.candle.begin.value / TS.projects.superalgos.globals.timeConstants.ONE_DAY_IN_MILISECONDS) * TS.projects.superalgos.globals.timeConstants.ONE_DAY_IN_MILISECONDS)
|
|
|
|
let fromDate = new Date(sessionParameters.timeRange.config.initialDatetime)
|
|
let lastDate = new Date(sessionParameters.timeRange.config.finalDatetime)
|
|
|
|
let currentDateString = heartBeatDate.getUTCFullYear() + '-' + utilities.pad(heartBeatDate.getUTCMonth() + 1, 2) + '-' + utilities.pad(heartBeatDate.getUTCDate(), 2)
|
|
let currentDate = new Date(heartBeatDate)
|
|
let percentage = TS.projects.superalgos.utilities.dateTimeFunctions.getPercentage(fromDate, currentDate, lastDate)
|
|
|
|
/*
|
|
Theere are a few tasks that we need to do only when the date changes,
|
|
otherwise it would be suboptimal.
|
|
*/
|
|
if (heartBeatDate.valueOf() !== previousHeartBeatDate) {
|
|
previousHeartBeatDate = heartBeatDate.valueOf()
|
|
|
|
let processingDate = heartBeatDate.getUTCFullYear() + '-' + utilities.pad(heartBeatDate.getUTCMonth() + 1, 2) + '-' + utilities.pad(heartBeatDate.getUTCDate(), 2)
|
|
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> loop -> Simulation ' + TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).SESSION_KEY + ' Loop # ' + tradingEngine.current.episode.candle.index.value + ' @ ' + processingDate) }
|
|
|
|
/* Logging to console and disk */
|
|
if (TS.projects.superalgos.utilities.dateTimeFunctions.areTheseDatesEqual(currentDate, new Date()) === false) {
|
|
TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.newInternalLoop(currentDate, percentage)
|
|
}
|
|
|
|
/* Date only hearbeat */
|
|
if (sessionParameters.heartbeats.config.date === true && sessionParameters.heartbeats.config.candleIndex === false) {
|
|
hartbeatText = hartbeatText + currentDateString
|
|
TS.projects.superalgos.functionLibraries.processFunctions.processHeartBeat(processIndex, hartbeatText, percentage)
|
|
return
|
|
}
|
|
}
|
|
|
|
/*
|
|
When the Candle Index nees to be shown, then we can not send the hearbet
|
|
only when the dates changes, we have to send it for every candle.
|
|
It might also contain the date information.
|
|
*/
|
|
if (sessionParameters.heartbeats.config.candleIndex === true) {
|
|
if (sessionParameters.heartbeats.config.date === true) {
|
|
hartbeatText = hartbeatText + currentDateString
|
|
}
|
|
hartbeatText = hartbeatText + ' Candle # ' + tradingEngine.current.episode.candle.index.value
|
|
TS.projects.superalgos.functionLibraries.processFunctions.processHeartBeat(processIndex, hartbeatText, percentage)
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
function positionChartAtCurrentCandle() {
|
|
/*
|
|
In conditions and Formulas, we want users to have an easy sintax to refer to indicators. In order to achieve that, we need the user to have
|
|
easy access to the current candle for instance, or the current bollinger band, meaning the one the Simulation is currently standing at.
|
|
For that reason we do the following processing, to have at the chart data structure the current objects of each indicator / time frame.
|
|
*/
|
|
let dataDependencies = TS.projects.superalgos.utilities.nodeFunctions.nodeBranchToArray(TS.projects.superalgos.globals.taskConstants.TASK_NODE.bot.processes[processIndex].referenceParent.processDependencies, 'Data Dependency')
|
|
dataDependencies = TS.projects.superalgos.utilities.nodeFunctions.filterOutNodeWihtoutReferenceParentFromNodeArray(dataDependencies)
|
|
|
|
/* Finding the Current Element on Market Files */
|
|
if (TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).TRADING_PROCESSING_DAILY_FILES) {
|
|
for (let j = 0; j < TS.projects.superalgos.globals.timeFrames.dailyFilePeriods().length; j++) {
|
|
let mapKey = TS.projects.superalgos.globals.timeFrames.dailyFilePeriods()[j][1]
|
|
let propertyName = 'at' + mapKey.replace('-', '')
|
|
let thisChart = chart[propertyName]
|
|
|
|
for (let k = 0; k < dataDependencies.length; k++) {
|
|
let dataDependencyNode = dataDependencies[k]
|
|
if (dataDependencyNode.referenceParent.config.codeName !== 'Multi-Period-Daily') { continue }
|
|
let singularVariableName = dataDependencyNode.referenceParent.parentNode.config.singularVariableName
|
|
let pluralVariableName = dataDependencyNode.referenceParent.parentNode.config.pluralVariableName
|
|
if (thisChart[pluralVariableName] !== undefined) {
|
|
let currentElement = getElement(thisChart[pluralVariableName], 'Daily' + '-' + mapKey + '-' + pluralVariableName)
|
|
if (currentElement !== undefined) {
|
|
thisChart[singularVariableName] = currentElement
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Finding the Current Element on Market Files */
|
|
for (let j = 0; j < TS.projects.superalgos.globals.timeFrames.marketFilesPeriods().length; j++) {
|
|
let mapKey = TS.projects.superalgos.globals.timeFrames.marketFilesPeriods()[j][1]
|
|
let propertyName = 'at' + mapKey.replace('-', '')
|
|
let thisChart = chart[propertyName]
|
|
|
|
for (let k = 0; k < dataDependencies.length; k++) {
|
|
let dataDependencyNode = dataDependencies[k]
|
|
if (dataDependencyNode.referenceParent.config.codeName !== 'Multi-Period-Market') { continue }
|
|
let singularVariableName = dataDependencyNode.referenceParent.parentNode.config.singularVariableName
|
|
let pluralVariableName = dataDependencyNode.referenceParent.parentNode.config.pluralVariableName
|
|
if (thisChart[pluralVariableName] !== undefined) {
|
|
let currentElement = getElement(thisChart[pluralVariableName], 'Market' + '-' + mapKey + '-' + pluralVariableName)
|
|
if (currentElement !== undefined) {
|
|
thisChart[singularVariableName] = currentElement
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
/* Finding the Current Element At Single Files*/
|
|
let propertyName = 'atAnyTimeFrame'
|
|
let thisChart = chart[propertyName]
|
|
|
|
for (let k = 0; k < dataDependencies.length; k++) {
|
|
let dataDependencyNode = dataDependencies[k]
|
|
if (dataDependencyNode.referenceParent.config.codeName !== 'Single-File') { continue }
|
|
let singularVariableName = dataDependencyNode.referenceParent.parentNode.config.singularVariableName
|
|
let pluralVariableName = dataDependencyNode.referenceParent.parentNode.config.pluralVariableName
|
|
let elementArray = thisChart[pluralVariableName]
|
|
let currentElement
|
|
if (elementArray !== undefined) {
|
|
currentElement = elementArray[elementArray.length - 1]
|
|
}
|
|
thisChart[singularVariableName] = currentElement
|
|
}
|
|
}
|
|
|
|
function getElement(pArray, datasetName) {
|
|
if (pArray === undefined) { return }
|
|
try {
|
|
let element
|
|
for (let i = 0; i < pArray.length; i++) {
|
|
element = pArray[i]
|
|
|
|
if (tradingEngine.current.episode.candle.end.value === element.end) { // when there is an exact match at the end we take that element
|
|
return element
|
|
} else {
|
|
if (
|
|
i > 0 &&
|
|
element.end > tradingEngine.current.episode.candle.end.value
|
|
) {
|
|
let previousElement = pArray[i - 1]
|
|
if (previousElement.end < tradingEngine.current.episode.candle.end.value) {
|
|
return previousElement // If one elements goes into the future of currentCandle, then we stop and take the previous element.
|
|
} else {
|
|
return
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return
|
|
} catch (err) {
|
|
TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[ERROR] runSimulation -> getElement -> datasetName = ' + datasetName)
|
|
TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[ERROR] runSimulation -> getElement -> err = ' + err.stack)
|
|
throw (TS.projects.superalgos.globals.standardResponses.DEFAULT_FAIL_RESPONSE)
|
|
}
|
|
}
|
|
|
|
function checkNextCandle() {
|
|
/*
|
|
We need to check that the candle we have just processed it is not the last candle.
|
|
The candle at the head of the market is already skipped from the loop because it has not closed yet.
|
|
Note: for Daily Files, this means that the last candle of each day will never be processed.
|
|
|
|
The first +1 is because array indexes are based on 0.
|
|
The second +1 is because we need to compare the next candle (remember that the loops allways avoid the
|
|
last candle of the dataset available.)
|
|
*/
|
|
if (tradingEngine.current.episode.candle.index.value + 1 + 1 === candles.length) {
|
|
/*
|
|
When processing daily files, we need a mechanism to turn from one day to the next one.
|
|
That mechanism is the one implemented here. If we detect that the next candle is the last candle of
|
|
the day, we will advance current process day one day. By doing so, during the next execution, the
|
|
simulation will receive the candles and indicators files of the next day.
|
|
*/
|
|
let candlesPerDay = TS.projects.superalgos.globals.timeConstants.ONE_DAY_IN_MILISECONDS / sessionParameters.timeFrame.config.value
|
|
if (
|
|
TS.projects.superalgos.globals.processVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).TRADING_PROCESSING_DAILY_FILES &&
|
|
tradingEngine.current.episode.candle.index.value + 1 + 1 === candlesPerDay
|
|
) {
|
|
/*
|
|
Here we found that the next candle of the dataset is the last candle of the day.
|
|
It is time to move to the next day so as to receive at the next execution, the indicator files from
|
|
the next day. At the same time we will reset the index to be pointing to
|
|
the first candle of the new dataset we shall receive. The first candle of the next day starts
|
|
at index 0, so we will position the index now at zero.
|
|
*/
|
|
tradingEngine.current.episode.candle.index.value = 0
|
|
tradingEngine.current.episode.processDate.value =
|
|
tradingEngine.current.episode.processDate.value + TS.projects.superalgos.globals.timeConstants.ONE_DAY_IN_MILISECONDS
|
|
return false
|
|
}
|
|
|
|
/*
|
|
We reached the head of the market but we are not at the last candle of a day during
|
|
Daily Files processing. We will advance to the next candle index anyways because in the
|
|
next execution it will likely have more candles at the dataset. And if it does not,
|
|
it will just wait there until it does.
|
|
*/
|
|
tradingEngine.current.episode.headOfTheMarket.value = true
|
|
tradingEngine.current.episode.candle.index.value++
|
|
return false
|
|
} else {
|
|
|
|
/* Wd did not reach the head of the market */
|
|
tradingEngine.current.episode.headOfTheMarket.value = false
|
|
tradingEngine.current.episode.candle.index.value++
|
|
return true
|
|
}
|
|
}
|
|
|
|
function checkInitialDatetime() {
|
|
/* Here we check that the current candle is not before the initial datetime defined at the session parameters.*/
|
|
if (tradingEngine.current.episode.candle.end.value < sessionParameters.timeRange.config.initialDatetime) {
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> checkInitialAndFinalDatetime -> Skipping Candle before the sessionParameters.timeRange.config.initialDatetime.') }
|
|
return false
|
|
}
|
|
return true
|
|
}
|
|
|
|
function checkFinalDatetime() {
|
|
/* Here we check that the next candle is not after of the user-defined final datetime at the session parameters.*/
|
|
if (tradingEngine.current.episode.candle.begin.value + sessionParameters.timeFrame.config.value > sessionParameters.timeRange.config.finalDatetime) {
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[INFO] runSimulation -> checkInitialAndFinalDatetime -> Skipping Candle after the sessionParameters.timeRange.config.finalDatetime.') }
|
|
return false
|
|
}
|
|
return true
|
|
}
|
|
|
|
function checkMinimunAndMaximunBalance() {
|
|
/* Checks for Minimun and Maximun Balance. We do the check while not inside any strategy only. */
|
|
if (
|
|
tradingEngine.current.strategy.index.value === tradingEngine.current.strategy.index.config.initialValue
|
|
) {
|
|
/*
|
|
We will perform this check only when we are not inside a position,
|
|
because there the balances have shifted from their resting position.
|
|
*/
|
|
|
|
let stopRunningDate = (new Date(tradingEngine.current.episode.candle.begin.value)).toLocaleString()
|
|
|
|
if (sessionParameters.sessionBaseAsset.config.minimumBalance !== undefined) {
|
|
if (tradingEngine.current.episode.episodeBaseAsset.balance.value <= sessionParameters.sessionBaseAsset.config.minimumBalance) {
|
|
const errorMessage = 'Min Balance reached @ ' + stopRunningDate
|
|
tradingSystem.errors.push([tradingSystem.id, errorMessage])
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[WARN] runSimulation -> checkMinimunAndMaximunBalance -> ' + errorMessage) }
|
|
return false
|
|
}
|
|
}
|
|
|
|
if (sessionParameters.sessionBaseAsset.config.maximumBalance !== undefined) {
|
|
if (tradingEngine.current.episode.episodeBaseAsset.balance.value >= sessionParameters.sessionBaseAsset.config.maximumBalance) {
|
|
const errorMessage = 'Max Balance reached @ ' + stopRunningDate
|
|
tradingSystem.errors.push([tradingSystem.id, errorMessage])
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[WARN] runSimulation -> checkMinimunAndMaximunBalance -> ' + errorMessage) }
|
|
return false
|
|
}
|
|
}
|
|
|
|
if (sessionParameters.sessionQuotedAsset.config.minimumBalance !== undefined) {
|
|
if (tradingEngine.current.episode.episodeQuotedAsset.balance.value <= sessionParameters.sessionQuotedAsset.config.minimumBalance) {
|
|
const errorMessage = 'Min Balance reached @ ' + stopRunningDate
|
|
tradingSystem.errors.push([tradingSystem.id, errorMessage])
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[WARN] runSimulation -> checkMinimunAndMaximunBalance -> ' + errorMessage) }
|
|
return false
|
|
}
|
|
}
|
|
|
|
if (sessionParameters.sessionQuotedAsset.config.maximumBalance !== undefined) {
|
|
if (tradingEngine.current.episode.episodeQuotedAsset.balance.value >= sessionParameters.sessionQuotedAsset.config.maximumBalance) {
|
|
const errorMessage = 'Max Balance reached @ ' + stopRunningDate
|
|
tradingSystem.errors.push([tradingSystem.id, errorMessage])
|
|
if (FULL_LOG === true) { TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[WARN] runSimulation -> checkMinimunAndMaximunBalance -> ' + errorMessage) }
|
|
return false
|
|
}
|
|
}
|
|
|
|
}
|
|
return true
|
|
}
|
|
} catch (err) {
|
|
TS.projects.superalgos.globals.loggerVariables.VARIABLES_BY_PROCESS_INDEX_MAP.get(processIndex).BOT_MAIN_LOOP_LOGGER_MODULE.write(MODULE_NAME, '[ERROR] runSimulation -> err = ' + err.stack)
|
|
throw (TS.projects.superalgos.globals.standardResponses.DEFAULT_FAIL_RESPONSE)
|
|
}
|
|
}
|
|
}
|
|
|