Variables

bot variables offer a flexible way to configure advanced bot automations for individual bots or for bots that need to communicate to each other if you have a need for conditional entry, exit, or adjustments based on the current bot's state or another bot's state, you might be able to accomplish that via bot variables these are considered advanced configuration and should only be used by experienced bot users please reach out to support if you need any help or clarification with variables what is a bot variable? a bot variable consists of a name and a value the name is some meaningful text that you provide that describes the variable, and the value is either additional text that you provide, or it is the current state of your bot such as # of open positions, current profit, current delta, or current days to expiration what can bot variables do? each variable that you configure is available to all of your bots to use to help control entries, exits, or adjustments this provides the ability for one bot to have rules that are based on what another bot is doing bot variables can also be read by the bot that controls it as well, allowing for more complex automations inside of a single bot bot variable ideas here is a list of automations that you can perform via bot variables this is not an exhaustive list, but just a list to give you some ideas about what is possible with variables variable ideas for entries only open a new position for bot b if bot a has no open positions only open a new position for bot b if bot a’s position is under 10 delta only open a new position if the last position closed at a profit only open a new position if a bot has lost less than $500 for the day disable all new entries for the remainder of the day but don’t disable bots or close existing positions enter a second position for your bot only if current profit is greater than 90% variable ideas for exits don’t trigger your bot’s 200% stop loss if the position’s delta is less than 50 disable all new exits for the remainder of the day but don’t disable bots or close existing positions execute monitored stops at 1 dte but not 0 dte, or vice versa only execute monitored stops on friday after 3 30pm close bot a’s position when bot b enters a new position creating a new bot variable you can create a new bot variable either from a single bot's "variables" menu or from your variables list bot variable fields bot (optional) if the variable is tied to a bot, then the value can be one of the bot properties (current profit, current dte, current delta, etc ) if the variable is not tied to a bot, then you can simply enter your own value for the variable for others to use this offers an easy way for you to have quick toggles or settings for multiple bots variable name (required) some text that describes the purpose or intent of the variable conditions (optional) if you wish for your variable to only have a value under certain conditions for the current bot, you can include those here the following conditions are available condition description day of week earliest/latest time of day earliest/latest time of day for last closed position today exited at earliest/latest time filters that will look at the time of day that the bot's last position closed for the current day if there are no closed positions for the current day, this condition will be met min/max open position count number of open positions the bot currently holds min/max positions entered today count number of new positions entered today by this bot min/max positions exited today count number of new positions exited today by this bot min/max current position delta current delta (x100 absolute value) for the bot's open position min/max current position minutes in trade minutes since entering the bot's current position min/max current position days in trade days since entering the bot's current position min/max current position minutes to expiration current minutes to expiration for the bot's open position min/max current position dte current days to expiration for the bot's open position min/max current position itm % % in the money for the current open position this will be "0" if the position is not in the money min/max current position mid price mid/market price of the current open position min/max current position profit $ current profit in dollars for the bot's open position min/max current position profit % current profit in percent for the bot's open position min/max bot last closed position today profit $ profit (in dollars) of the last position closed today by the bot this will be $0 if no positions closed today min/max bot profit realized today $ total profit (in dollars) for all positions closed by a bot today this will be $0 if no positions closed today if you use one of the bot position values above, and your bot currently has more than one position open, then the variable will utilize the value from the position that was entered first if you include conditions, the variable will only have a value if all conditions are met if a variable has no conditions, then it will always have a value value to set (required) this is the actual value for the variable it can either be free text (defined by you), or it can be one of the following values from the bot value description bot current position open count number of open positions the bot currently holds bot positions entered today count number of new positions entered today by this bot bot positions exited today count number of new positions exited today by this bot bot current position delta current delta (x100 absolute value) for the bot's open position bot current position minutes in trade minutes since entering the bot's current position bot current position days in trade days since entering the bot's current position bot current position minutes to expiration current minutes to expiration for the bot's open position bot current position dte current days to expiration for the bot's open position bot current position itm % % in the money for the current open position this will be "0" if the position is not in the money bot current position mid price mid/market price of the current open position bot current position profit $ current profit in dollars for the bot's open position bot current position profit % current profit in percent for the bot's open position last closed position today profit $ profit (in dollars) of the last position closed today by the bot this will be $0 if no positions closed today bot profit realized today $ total profit (in dollars) for all positions closed by a bot today this will be $0 if no positions closed today if you use one of the bot position values above, and your bot currently has more than one position open, then the variable will utilize the value from the position that was entered first this is the value that will be available for other bots to use for the entry, exit, and adjustments using variables using variables for entry conditions if you would like to restrict new position entries based on bot variables, you can do that by editing the bot's entry condition and then adding the variable(s) to the "variables (advanced)" section a bot's entry condition can accept any number of variables variables that are configured for bot entry must all be true in order for bot entry to be valid when your bot is ready for a new position, it will evaluate all entry conditions, including all variables, and only open a new position if everything passes using variables for exit conditions if you would like to restrict monitored stops based on bot variables, you may do so by editing the bot's exit condition and adding the variables inside of the variables (advanced) section under monitored stops monitored stops are exits such as stop loss %, delta stop, and itm % (not profit targets!) a bot's exit condition can accept any number of variables variables that are configured for bot exit must all be true in order for the monitored stop to be valid when your bot's monitored stop level is met (stop loss, delta, itm %), the bot will also evaluate all variables configured for the exit condition, and the bot will only stop out if all variables (if any) are true bot variables on exit conditions only apply to monitored stops if you would like to apply variables to profit targets (standing orders) , you need to add those variables to the appropriate bot adjustments (next section) using variables for adjustments if you wish to restrict bot adjustments based on variables, you can do that by editing the adjustment itself and adding your variables to the adjustment if an adjustment has any variables tied to it, that adjustment will only execute of all variable conditions are met this is useful for conditionally removing or adding profit targets or closing a position early based on the condition of the current bot or another bot bot variable update frequency bot variables update throughout the trading session, but they are not real time (with one exception ) there can be a 30 60 second delay between when the bot's condition (ie profit $, delta value) changes and when the variable records that current value so if your bot opens a position or profit goes to 100%, the variable will not reflect that change immediately the variable might not reflect it until 60 seconds later please plan accordingly when establishing your entry, exit, and adjustments that are based on variables there is an exception to delayed variable updates throughout the day, and that is when a bot position opens or closes when a bot position opens or closes, any variables that pull values from that bot will update immediately bot variable resets bot variables update throughout the day for any bot that is enabled if a bot is disabled, any variables based on that bot's state will clear out to no value (ie open position count, last realized profit, total realized profit, positions entered/exited today) variables will also clear their value after market close every day variables that are not tied to a bot's state (variables where you specify free text values) will hold their value until you change it bot variable tips bot variables can be confusing! before you start to incorporate a new variable into your bot's entry, exit, or adjustment, check the variable value itself and ensure that it is updating as you would expect it to you can view all of your variables and their current values on your variables list https //whispertrades com/bots/variables if you need any help with variables, don't hesitate to reach out for support!