Skip to content
StatePath
Tool Atlasindicator.alert

Tool

Alert

indicator.alert

OutputSink

Inputs

whenBoolean

The firing condition — a per-bar boolean. Alerts never fire on the forming bar.

levelBuffer (time series)

The price level an intrabar alert watches. It is read from the LAST CLOSED bar, so the level itself never repaints while the current bar forms.

valueBuffer (time series)

Optional numeric series feeding the {value} placeholder, formatted at the symbol's digits.

Outputs

Bundle (untagged)

Alert is a terminal sink — it dispatches notifications and outputs nothing. Nothing can be wired from it.

Alert fires terminal notifications when a wired condition turns true on a just-closed bar — chart popup, sound, mobile push, and email, with a templated message.

Alert overview diagram

How it works

Wire any boolean into 'when'. On each just-closed bar where it is true, the alert fires through every selected channel: the Alert popup, a built-in terminal sound, a push notification to the terminal's MetaQuotes ID, and/or an email. The message template substitutes {symbol} {timeframe} {time} {price} {value} {name} and clamps at 252 characters. Alerts arm only after the first full history paint (no storm on attach), fire at most once per closed bar plus an optional per-node cooldown, and share the terminal push budget of 2 per second / 10 per minute — over-budget pushes are dropped with a journal line. All channels are inert in the Strategy Tester.

Modes

Channels options

Popuppopup

Opens the terminal's Alert window with the message.

Popup diagram
Soundsound

Plays one of the terminal's built-in sounds.

Sound diagram
Pushpush

Sends a mobile push notification via the MetaQuotes ID (budgeted: 2 per second, 10 per minute).

Push diagram
Emailemail

Sends an email through the terminal's Email settings.

Email diagram

Sound source options

Built-inbuiltin

Plays one of the terminal's 13 bundled sounds — nothing is embedded and the artifact stays byte-identical to one with no sound at all.

Built-in diagram
Customcustom

Plays a WAV from your sound library. The file is embedded in the compiled indicator, so the person running it needs no separate install — and deleting it from your library never changes an artifact already compiled.

Custom diagram

Sound options

alertalert

Plays the built-in 'alert' terminal sound.

alert diagram
alert2alert2

Plays the built-in 'alert2' terminal sound.

alert2 diagram
connectconnect

Plays the built-in 'connect' terminal sound.

connect diagram
disconnectdisconnect

Plays the built-in 'disconnect' terminal sound.

disconnect diagram
emailemail

Plays the built-in 'email' terminal sound.

email diagram
expertexpert

Plays the built-in 'expert' terminal sound.

expert diagram
newsnews

Plays the built-in 'news' terminal sound.

news diagram
okok

Plays the built-in 'ok' terminal sound.

ok diagram
requestrequest

Plays the built-in 'request' terminal sound.

request diagram
stopsstops

Plays the built-in 'stops' terminal sound.

stops diagram
ticktick

Plays the built-in 'tick' terminal sound.

tick diagram
timeouttimeout

Plays the built-in 'timeout' terminal sound.

timeout diagram
waitwait

Plays the built-in 'wait' terminal sound.

wait diagram

Trigger options

Once per baronce_per_bar

Fires at most once per closed bar, keyed on the bar's open time.

Once per bar diagram
Intrabarintrabar

Watches the live price against a level while the bar is still forming — at most one fire per forming bar. Faster than waiting for the close, but the bar can still reverse and a fire cannot be taken back.

Intrabar diagram

Intrabar mode options

Touchtouch

Fires when the forming bar's range spans the level — its low is at or below it and its high at or above it.

Touch diagram
Cross upcross_up

Fires when the last closed bar closed at or below the level and the live price is above it.

Cross up diagram
Cross downcross_down

Fires when the last closed bar closed at or above the level and the live price is below it.

Cross down diagram

Configuration

channelsmulti_enum

Where the alert goes: chart popup, terminal sound, mobile push (needs a MetaQuotes ID), and/or email (needs the terminal Email tab configured).

Choices:popupsoundpushemail
sound_sourceenum

Whether the sound channel plays one of the terminal's built-in sounds or a WAV from your own sound library.

Choices:builtincustom
soundenum

Built-in terminal sound to play (the .wav extension is added automatically).

Choices:alertalert2connectdisconnectemailexpertnewsokrequeststopsticktimeoutwait
custom_soundscalar

Which uploaded sound to play, by its id in your sound library. The WAV is embedded at compile time.

message_templatescalar

Alert text. Placeholders: {symbol} {timeframe} {time} {price} {value} {name}. Messages longer than 252 characters are clamped with an ellipsis.

triggerenum

When the condition may fire. v1 fires at most once per closed bar; intrabar triggers are a planned extension.

Choices:once_per_barintrabar
intrabar_modeenum

How the live price is compared with the level while the bar forms: touch, cross up, or cross down. Only used by the intrabar trigger.

Choices:touchcross_upcross_down
cooldown_secondsscalar

Minimum seconds between fires of THIS alert node (0 = every qualifying bar). Push alerts also share the terminal budget of 2 per second and 10 per minute.

Connects to

Reads from

See also