Configuring Alerts

<< Click to Display Table of Contents >>

Navigation:  Operations > Alerts >

Configuring Alerts

Previous page Return to chapter overview Next page

Show/Hide Hidden Text

Alerts can be created using conditions which monitor various "objects" which exist on the chart, or market analyzer display.  Possible Condition Objects include a chart's data series, indicators, drawing tools, or any Market Analyzer column value.



tog_minus        How to add a condition object

Adding an alert from the alert dialog

You can create a new generic alert by first accessing the Alerts Dialog window, and selecting the "add" text which will add a new alert to your configured alerts panel.




Any suitable object which currently exists on the window or tab will be available to use as a Condition Object for the alert.  For example, if you have a Market Analyzer with several customized columns added, you will be able to use any of those columns as a Condition Object.  A Chart will work the same way in that any data series, indicator, or drawing object that currently exists on the chart will be available as a Condition Object.


Creating an alert from a chart indicator

If you have an indicator configured on an existing chart you wish to use in your alert condition, you can easily access this by first left mouse clicking on the indicator plot to select the indicator, and then selecting Alert




Doing so will automatically add the selected indicator as an object that is used in the Conditions properties.



Adding an alert from a chart drawing object

Drawing tools which exist on a chart can also be added as a condition object by first left clicking on the drawing tool, then selecting Alert.




Doing so will automatically add the selected drawing tool as an object that is used in the Conditions properties.





Adding an alert from a chart data series

If you have multiple data series on your chart (e.g., 5 minute and 10 minute data series), you can select one of these series to be used as an condition object. Simply left mouse click on the chart data series itself, and select Alert




Doing so will automatically add the selected data series as an object that is used in the Conditions properties.



tog_minus        Understand the general alert properties

General Alert Properties

The General section allow you to configure the following alert properties:



When checked, the current alert will be active


Sets the displayed name of the alert

Apply to

Determines which instrument(s) are used to be monitored by the alert.

Rearm type

Sets under what condition the alert will rearm.  Possible options are listed in the table below:



The alert will only trigger once and never rearm

On timer

Rearm after a specific number of seconds defined in the rearm seconds property

On bar close

Rearm on the next bar close for the data series used in the alert condition. Only columns which have a data series are eligible for OnBarClose alerts.

On condition reversed

Rearm once the condition is no longer true

On connect*

Rearm after NinjaTrader has been manually connected to a data provider


Once triggered the alert will never rearm and be removed.

Rearm seconds

Sets the number of seconds an alert will rearm. If the same alert is called within a time window of the time of last alert Rearm seconds, the alert will be ignored (only visible if Rearm type option 'On timer' is selected)


*The On connect rearm type is aware of 4 different types of connection events which will define how the On connect rearm type behaves:




Rearm behavior

Manual disconnect

When user has selected to disconnect from the data provider, or shut down NinjaTrader

Alert will be disabled

Manual reconnect

When a user has selected to connect to a data provider

Alert will be rearmed


When the data provider has been temporarily disconnected due to connectivity issues

Alert will just stay in active state and will wait for reconnect.


When the data provider connection has recovered from the lost connection

Alert will resume in active state




Applying alerts to specific instruments

If you are using a window which has multiple instruments, such as a Market Analyzer, or a Chart with multiple data series, the default behavior will be monitor "All" instruments contained in that window tab.


By selecting the Magnify glass icon next to the Apply to property, a new window will appear which will list all of the configured instruments and allow you to select a specific set of instruments to be monitored by the alert:


1.From the newly opened Instruments window, select the instruments you wish to apply the condition to


Tip:   Multi-select is supported in the Instrument window:

To select a consecutive instruments, click the first instrument, press and hold down the Shift key, and then click the last instrument.
To select non-consecutive instruments, press and hold down the Ctrl key, and then click each instrument that you want to select.





2. Press OK on the Instruments window


3. Your Apply to field will now list the instrument names you selected earlier, indicating that alerts will only be triggered on instruments contained in this list.




Tip: You can also simply type in the Apply to field to add a specific instrument, or use your backspace key to delete a specific instrument

tog_minus        Understanding the conditions properties

Alert Conditions

The Alert Conditions allow you to define the exactly what the alert will monitor.


1.  Set Conditions to match "If Any" or "If All" of the following conditions are met:

If Any

Alert if any of the listed conditions are true

If All

Alert only if all of the listed conditions are true


2.  A list of the current objects and conditions to monitor

3.  Add a new condition, or edit and remove existing conditions




Managing Alert Conditions

To define a new alert condition, select the "add" text which will open a Condition Builder window where you can specify exactly which condition to monitor.  Please see our Help Guide article on the Condition Builder for information on defining an alert condition.

The "edit" text will allow you to edit a selected condition.


Selecting "remove" will remove the selected condition.

tog_minus        Understanding the alert message properties

Alert Message

The alert message properties allow you to define general settings for how the alert is treated when the condition is satisfied.  All alerts that are generated are sent to to the Alerts Log window and will display the message you configured in this section.  You will also be able to control the priority of the alert, as well as background and foreground colors used.



The text that is displayed in the Alerts Log window.  There are a number of keywords which begin with an "@" symbol which will work as variables to fill in information related to the alert, such as the Instrument, Time, Price, etc.


The priority of the alert for filtering and sorting in the Alerts Log window

Color for background

The color used for the grid background in the Alerts Log

Color for foreground

The text color used in the Alerts Log

tog_minus        Understanding the action properties


When an alert has been triggered, there are a number of customizable actions that can be taken at that time.  These actions include the following:


Play Sound

Play a user defined sound file.  Sounds can include system default sounds, or custom sound files


Share a message or screenshot to a selected Sharing Service

Pop Up Dialog

Display a Pop Up Dialog with a custom message

Submit Order

Submit a custom order


Configuring Actions

To access these actions, you will need to make sure the Actions group is expanded by selecting the arrow next to this field in the Alerts properties menu as per the screen shot below:




Selecting the "add" text will open the Actions window where you can define the custom actions.  You can setup as many custom actions as you would like.  This means you can have an alert do more than one custom action as you want.  For example, you can set an alert to Play a Sound and Share a message to a Sharing Service under he same condition.




Working with Actions Templates

After configuring Actions, you can right click within the Actions columns, select Template, and Save As to create a template. Within the right click menu is also where you would be able to load any saved templates




Actions Property Definitions



Sets the location of the sound file to be played



Sets the text that is sent to the sharing service

Screenshot type

Optional image to be attached with the message. Possible screen shot types are:


None - No screen shot is included with the message
Chart -  A screen shot of the chart that generated the alert will be sent
Tab - A screen shot of the Tab that generated the alert will be sent
Window - A screen shot of the entire window that generated the alert will be sent



Share to

Selects the Sharing Service that the alert message is sent to.

Pop Up Dialog

Note:  There is no property for this section and is intentionally left blank.  The pop up dialog will use the "Message" that is configured on the Alert Message section of the Alerts window

Submit Order


Selects the account the order is submitted

Limit Price

Sets the limit price used for the order

Order action

Selects the type of action used.  Possible order actions are:


Buy to cover
Sell short



Order type

Selects the type of order used.  Possible order types are:






Sets the order quantity that is used for the order

Stop Price

Sets the stop price used for the order

Time in force

Selects the TIF (Time in Force) used for the order.  Possible TIF setting are: