EA Setup

MetaTrader 4

Alerts

Low-Code Alerts

No-Code Alerts

Message Structure

Expert Advisor

Others

Syntax

💡

What in the world is syntax? Syntax is the structure of commands and other components for your alert messages. Non-compliance will result in the EA rejecting your signal.

💡

Components

License ID: long number found in the Licensing Dashboard
Commands: do not have the equal (=) sign such as “buy”
Symbol: asset or instrument you’d like to enter, exit or modify
Others: components with the equal (=) sign such “risk=”

Structure

Syntax will always be in this sequence: LicenseID,Command,Symbol,Others
Syntax components are separated by a comma (,) and without any spacing between them
There can only be 1 License ID, Command and Symbol per alert

Acceptable PineConnector Syntax

LicenseID,Command,Symbol,Others

Unacceptable PineConnector Syntax

1. Command,LicenseID,Symbol (incorrect order)
2. LicenseID,Command,Command (multiple Commands)
3. LicenseID,LicenseID,Command,Symbol (multiple LicenseIDs)

buy

Place a buy order at the market. risk= is a required parameter.

LicenseID,buy,EURUSD,risk=0.01
LicenseID,buy,US30.Cash,risk=1

sell

Place a sell order at the market. risk= is a required parameter.

LicenseID,sell,EURUSD,risk=0.01
LicenseID,sell,DAX30,risk=2

risk=

💡

required parameter for all entry commands such as buy and buylimit

Function depends on the “Volume Type” selected in the EA EA Options: dollar amount, specified volume, percentage of balance.

LicenseID,buy,EURUSD,risk=0.01
LicenseID,sell,EURCAD,risk=2

sl=

Place stop-loss. Computation is based on the Target Type selected in the EA EA Options: Pips, Price and Percentage.

LicenseID,buy,EURUSD,risk=1,sl=10.5

tp=

Place take-profit. Computation is based on the Target Type selected in the EA EA Options: Pips, Price and Percentage.

LicenseID,buy,EURUSD,risk=1,tp=15

comment=

Add a string into the order’s comment section. Valid for entry commands only (buy, buylimit etc).

LicenseID,buy,EURUSD,risk=1,comment="Strategy 1"
LicenseID,buy,EURUSD,risk=1,comment="Strategy 2"

eaoff

Halts the PineConnector EA If the EA is halted, incoming signals will not be processed

LicenseID,eaoff,eaoff

eaon

Reactivates the PineConnector EA from halt

LicenseID,eaon,eaon

closelong

Close all buy positions of the specified symbol.

LicenseID,closelong,EURUSD

closeshort

Close all sell positions of the specified symbol.

LicenseID,closeshort,EURUSD

closelongbuy

Close all buy positions and open a new buy.

LicenseID,closelongbuy,EURUSD

closeshortsell

Close all sell positions and open a new sell.

LicenseID,closeshortsell,EURUSD

newsltplong

Modify the stop-loss (SL) and take-profit (TP) of the buy positions. New SL and TP are computed based on your selected Target Type on the EA.

LicenseID,newsltplong,EURUSD,sl=10
LicenseID,newsltplong,EURUSD,tp=20
LicenseID,newsltplong,EURUSD,sl=30,tp=60

newsltpshort

Modify the stop-loss (SL) and take-profit (TP) of the sell positions. New SL and TP are computed based on your selected Target Type on the EA.

LicenseID,newsltpshort,EURUSD,sl=10
LicenseID,newsltpshort,EURUSD,tp=20
LicenseID,newsltpshort,EURUSD,sl=30,tp=60

closelongpct

Close a percentage of buy positions, based on your selected partial close percentage in the EA (25%, 34%, and 50%).

LicenseID,closelongpct,EURUSD

closeshortpct

Close a percentage of sell positions, based on your selected partial close percentage in the EA (25%, 34%, and 50%).

LicenseID,closeshortpct,EURUSD

closelongvol

Close buy positions up to the indicated value. risk= is a required parameter.

LicenseID,closelongvol,risk=3
LicenseID,closelongvol,risk=0.5

closeshortvol

Close sell positions up to the indicated value. risk= is a required parameter.

LicenseID,closeshortvol,risk=3
LicenseID,closeshortvol,risk=0.5

price=

Computing pending order entry price. EA Options: Pips, Specified Price, Percentage

LicenseID,buystop,EURUSD,price=10,risk=1

buystop

Place buy stop above the current market price. price= is a required parameter.

LicenseID,buystop,EURUSD,price=10,risk=1

buylimit

Place buy limit below the current market price. price= is a required parameter.

LicenseID,buylimit,EURUSD,price=10,risk=1

sellstop

Place sell stop below the current market price. price= is a required parameter.

LicenseID,sellstop,EURUSD,price=10,risk=1

selllimit

Place sell limit above the current market price. price= is a required parameter.

LicenseID,selllimit,EURUSD,price=10,risk=1

cancellong

Cancels all long orders with the specified symbol.

LicenseID,cancellong,EURUSD

cancelshort

Cancels all short orders with the specified symbol.

LicenseID,cancelshort,EURUSD

cancellongbuystop

Cancels all long orders with the specified symbol and places a buystop order. risk= and price= are required parameters.

LicenseID,cancellongbuystop,EURUSD,risk=1,price=10,sl=15,tp=20

cancellongbuylimit

Cancels all long orders with the specified symbol and places a buylimit order. risk= and price= are required parameters.

LicenseID,cancellongbuylimit,EURUSD,risk=1,price=10,sl=15,tp=20

cancelshortsellstop

Cancels all short orders with the specified symbol and places a sellstop order. risk= and price= are required parameters.

LicenseID,cancelshortsellstop,EURUSD,risk=1,price=10,sl=15,tp=20

cancelshortselllimit

Cancels all short orders with the specified symbol and places a selllimit order. risk= and price= are required parameters.

LicenseID,cancelshortselllimit,EURUSD,risk=1,price=10,sl=15,tp=20

newsltpbuystop

Modify the stop-loss (SL) and take-profit (TP) of the buystop orders. New SL and TP are computed based on your selected Target Type on the EA.

LicenseID,newsltpbuystop,EURUSD,sl=10
LicenseID,newsltpbuystop,EURUSD,tp=20
LicenseID,newsltpbuystop,EURUSD,sl=30,tp=60

newsltpbuylimit

Modify the stop-loss (SL) and take-profit (TP) of the buylimit orders. New SL and TP are computed based on your selected Target Type on the EA.

LicenseID,newsltpbuylimit,EURUSD,sl=10
LicenseID,newsltpbuylimit,EURUSD,tp=20
LicenseID,newsltpbuylimit,EURUSD,sl=30,tp=60

newsltpsellstop

Modify the stop-loss (SL) and take-profit (TP) of the sellstop orders. New SL and TP are computed based on your selected Target Type on the EA.

LicenseID,newsltpsellstop,EURUSD,sl=10
LicenseID,newsltpsellstop,EURUSD,tp=20
LicenseID,newsltpsellstop,EURUSD,sl=30,tp=60

newsltpselllimit

Modify the stop-loss (SL) and take-profit (TP) of the selllimit orders. New SL and TP are computed based on your selected Target Type on the EA.

LicenseID,newsltpselllimit,EURUSD,sl=10
LicenseID,newsltpselllimit,EURUSD,tp=20
LicenseID,newsltpselllimit,EURUSD,sl=30,tp=60

Breakeven

Automatically move the SL of the position to breakeven when betrigger= is satisfied
Ensure that beoffset < betrigger

betrigger=

Breakeven will be activated after the position gains this number of pips. Ensure > 0

beoffset=

Offset from entry price. 0 means the SL will be placed exactly at entry price. 1 means 1 pip above the entry price for buy trades and 1 pip below for sell trades. this is the amount of pips you'd like to protect.

LicenseID,buy,EURUSD,risk=1,sl=20,betrigger=10,beoffset=2

💡

Assumptions Target Type: Pips Volume Type: Specified Volume Interpretation Buy 1 lot of EURUSD with SL 20 pips away from market price Breakeven feature to trigger after price moves 10 favourable pips and SL to be placed 2 pips above entry price

Pip Trailing

Automatically moves SL with the direction of the trade (up for longs, and down for shorts)
All trailing parameters are restricted to integers — floats will be rounded to the nearest integer
Trailing computation will be based on pips, regardless of the Target Type selected

💡

Spelling Bee Please check that you spell “trailing” correctly in your syntax. Some users faced syntax issues as they spelled it as “trialing”.

trailtrig=

Trailing stop-loss will be activated after a trade gains this number of pips.

traildist=

Distance of the trailing stop-loss from current price. SL will be opened at traildist after trailtrig is met, even if you do not have a SL placed.

trailstep=

Moves trailing stop-loss once price moves to favourable by a specified number of pips.

LicenseID,buy,EURUSD,risk=1,trailtrig=12,traildist=8,trailstep=3

💡

Interpretation

With trailtrig=12, the first instance of trailing SL will be when price moves favourably for 12 pips (entry+12).

The SL will be placed 8 pips lower at (entry+12-8).

If you have a SL, the SL will be updated
If you do not have a SL, a SL will be created for you

With trailstep=3, the second instance of trailing SL is when price moves favourably for another 3 pips (entry+12+3).

The SL will be placed at 8 pips lower at (entry+12+3-8).

The third instance will be when price moves another 3 favourable pips (entry+12+3+3)

The SL will be placed 8 pips lower at (entry+12+3+3-8), and so on.

💡

When trading non-FX, such as the US100, using a value of 10 may mean 1 point in the index. Do test it first and refer to the Experts Tab — the EA will print trailing information such as the price where the trailing feature will begin

ATR Trailing

Instead of your SL trailing based on pips, your SL trails based on the ATR computed
Only atrtimeframe= and atrperiod= are mandatory — other parameters are optional

atrtimeframe=

ATR Trailing Stop will be based on the specified timeframe in minutes and will only update once per bar close. If stop loss not specified at the point of entry, a SL will be automatically added with the ATR values used.

Allowable timeframe values:

1 (1 minute),
5 (5 minutes),
15 (15 minutes),
30 (30 minutes),
60 (1 hour),
240 (4 hours),
1440 (1 day)

atrperiod=

ATR averaging period

atrmultiplier=

ATR Multiplier Default = 1

atrshift=

ATR Shift Default: 0

atrtrigger=

Activate the trigger of ATR Trailing after market moves favourably by a number of pips. Default: 0 (instantaneous)

LicenseID,buy,EURUSD,risk=1,sl=10,
atrtimeframe=60,atrperiod=14,atrmultiplier=2,atrtrigger=8

💡

Interpretation Buy EURUSD at the market with SL placed 10 pips away ATR Trailing will begin after 8 pips of favorable move ATR is computed using the average of the previous 14 60-min candles, multiplied by 2.

Filters

spread=

Enter the position only if the spread is equal or less than the specified value in pips.

LicenseID,buy,EURUSD,risk=1,spread=2
LicenseID,buy,EURUSD,risk=1,spread=1.22

accfilter=

Enter the position only if the account requirement is met. EA Options: Account Balance, Account Equity, Margin Percentage and Free Margin

LicenseID,buy,EURUSD,risk=1,accfilter=500

💡

Assumption Account Balance EA option selected Interpretation If Account Balance is $500 or higher, process buy signal If Account Balance is less than $500, ignore buy signal

← Previous

Send a Test Alert

EA Settings