Alerts Syntax

To auto-execute trades in MetaTrader, alerts need to be triggered on TradingView or in Telegram channel. Once an alert fires, it is forwarded by TradingConnector for execution.

Alerts - for example ‘long tradesymbol=EURUSD sl=100 tp=150 lotsize=0.15’ must be constructed in a specific way:

KEYWORD - each alert must contain 1 and only 1 of the basic mandatory commands: long (or buy), short (or sell), closelong, closeshort, cancel long, cancel short, closepart, slmod, tpmod, closeall, closeall_on_ticker.

* TRADESYMBOL - a way to specify which ticker/symbol/asset the alert is designated for - is mandatory, but sometimes optional parameter. Why sometimes optional? Alert set on TradingView is always attached to particular symbol (so it is not possible to set something like 1 alert for all forex pairs) and this symbol is forwarded in alert’s header. TradingConnector retrieves symbol from the header, so there is no need to duplicate this information also inside alert message. HOWEVER sometimes symbol name on TradingView and on MetaTrader do not match - in such case tradesymbol=EURUSD parameter (where ‘EURUSD’ is symbol name on MetaTrader) must be added to alert message, to OVERRIDE whatever is found in the header.

Messages incoming from Telegram do not include headers. Whatever stands at the beginning of alert message (until first space) will be considered as a header, so this will be valid alert message: ‘EURUSD long’. If not at the beginning, add parameter name, like this: ‘long tradesymbol=EURUSD’

** PARAMETERS - adding parameters to alert message is optional because of 2 reasons:

1. you may not want to attach stop-loss or take-profit or any other parameters to the position, or

2. you may want to attach trade parameters specified in EAconfig (how to open EAconfig is explained at the bottom of this page). There is an extensive set of parameters which can be set in EAconfig like stop-loss, lot size, trailing and more and they will be applied to each and every incoming alert under one condition - they are not found in alert message. Each time a certain parameter is found in alert message, its value will OVERRIDE whatever is set in EAconfig. For example, if StopLoss and TakeProfit are both set to 50 pips in EAconfig and alert saying “long sl=25” is received, a long position will be entered with StopLoss=25 and TakeProfit=50.

As per above requirements even most simple alert messages saying only ‘long’ or ‘short’ triggered by the TradingView would be VALID for TradingConnector.

It doesn’t matter in which order parameters are specified in the alert. Parameters must be divided by spaces, not commas or semicolons.

Reversing Orders Automatically

Most common question asked is how to send 2 alerts - one to close long and second to open short entry (or vice versa) - making sure second alert is slightly delayed to make sure it is not executed first.

The answer: no need to worry about it. If ‘short’ entry alert comes in when long position is opened (or vice versa), that long position is automatically closed before entering short.

That is default behaviour and TradingConnector works like this when “Allow Hedging” is set to FALSE in EAconfig. But it can be changed to TRUE - in such case opened positions will not get automatically closed on reversing entry order.

Parameters

Pending ORders

MULTIPLE TAKE PROFIT DISTANCES

It is also possible to set profit taking at multiple pre-defined levels. Up to 3 levels. Example entry alert defining these take profit levels looks like this:

partN value is initial lot size part for closing. For example if “part=0.3” and initial lot size was 0.1 lot, only 0.03 lot will be closed when reaching defined level.

1) part=0.3 -> 0.03 will be closed, 0.07 lot continues

2) part=0.4 -> 0.04 will be closed, 0.03 lot continues

3) part=0.3 -> 0.03 will be closed, nothing is left in the trade

MULTIPLE TAKE PROFIT LEVELS

long tpprice1=30 part1=0.3 tpprice2=45 part2=0.4 tpprice3=55 part3=0.3

PARTIAL CLOSING

part value is initial lot size part for closing. It works exactly as partN in “Multiple take profit levels” section described above.

TRADES MODIFICATION (FOR MOVING STOP-LOSS, Take-Profit)

TradingConnector enables modifying ongoing trades, for example to develop Moving Stop-Loss feature. Commands are SLMOD and TPMOD. Here is example alert:

slmod slprice=1.11111

Where 1.11111 is the new level of a stop-loss.

The same works for moving take-profit:

tpmod tpprice=1.22222

‘ONLYTC’ TO AVOID INTERFERENCE WITH OTHER ALERTS

By default TradingConnector listens to all alerts which are triggered by TradingView. So there is a chance you have also set other alerts, which you wouldn’t like to be auto-executed in MetaTrader. But those alerts contain keywords like “long” or “short”, so TradingConnector will try to execute them in MetaTrader.

How to avoid it? Enable “Require ‘onlytc’ parameter in alerts” setting in EAconfig and add “onlytc” string to your alert. All alerts without this string will be ignored by TradingConnector. So your alert should look like this:

long onlytc sl=1.20000 tp=1.33000

Multiple Accounts

ADVANCED: CLOSE OR MODIFY SPECIFIC POSITION ONLY WITH TRADEID=

Let’s say there are multiple positions on the same symbol opened, and you only want to close one of them. To do this, you need to add tradeid= parameter to the alert.

However, this can be done only for positions, which were marked with that specific tradeid by the entry alert, like this:

An example of tradeid= implementation in a complete strategy can be found in this example script: https://www.tradingview.com/script/BTSkg8IP-TradingView-Alerts-to-MT4-MT5-Forex-indices-commodities/

Expert Advisor configuration

To access EAconfig in your MetaTrader, right-click on the chart TradingConnectorEA is attached to, then “Expert List” and “Properties”.

New features are coming up soon. Subscribe to our NEWSLETTER to get info about new releases first hand!