EA Setup

MetaTrader 4

MetaTrader 5

Alerts

Message Structure

Expert Advisor

Debugging

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. Signal Log If signals are not appearing on your MetaTrader terminal, you may check your Signals Log in the members area.

Rejected signals will not appear in the Signals Log.

💡

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.

💡

Valid Alternatives (case-insensitive)

long
bull
bullish

💡

risk= is a required parameter

LicenseID,buy,EURUSD,risk=0.01
LicenseID,long,US30.Cash,risk=1
LicenseID,bullish,GBPJPY,risk=1

sell

Place a sell order at the market.

💡

Valid Alternatives (case-insensitive)

short
bear
bearish

💡

risk= is a required parameter

LicenseID,sell,EURUSD,risk=0.01
LicenseID,short,DAX30,risk=2
LicenseID,bear,GBPJPY,risk=1

risk=

💡

required parameter for all entry commands such as buy and buylimit

Function depends on the “Volume Type” selected in the EA EA Options: Lots, Dollar Amount, Percentage of Balance (Lots) and Percentage of Balance (Loss).

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).

💡

please ensure the comment is in quotation marks “ “

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

closeall

Close all positions and orders, regardless of symbol

💡

If you are looking to close positions only with the indicated symbol, use “closelong”, “closeshort” or “closelongshort” instead.

LicenseID,closeall,EURUSD

💡

Safety Measure The command will only work if the right symbol is indicated. Indicate the symbol where the PineConnector EA is running on. If the PineConnector EA is running on GBPJPY.a, indicate “GBPJPY.a” instead of “EURUSD”.

closealleaoff

Close all positions and orders, and off/halt the PineConnector EA.

LicenseID,closealleaoff,EURUSD

💡

closelong

Close all buy positions of the specified symbol.

LicenseID,closelong,EURUSD

closeshort

Close all sell positions of the specified symbol.

LicenseID,closeshort,EURUSD

closelongshort

Close all buy and sell positions of the specified symbol.

LicenseID,closelongshort,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

LicenseID,newsltplong,EURUSD,sl=1.12345 (price)
LicenseID,newsltplong,EURUSD,sl=1,tp=2 (percentage)

LicenseID,newsltplong,EURUSD,sl=0 (breakeven)

💡

Pips With sl=10, EA will compute your SL 10 pips away from the current market price. Percentage With sl=1, EA will compute your SL 1% away from the current market price.

💡

Move SL to Breakeven To move the SL of all your buy positions for the specified symbol to breakeven, indicate sl=0.

💡

Required Conditions

Position is in profit
Current market price is sufficiently far from the entry price

If either of the conditions are not met, sending in a “newsltplong” with sl=0 will result in the Error 130 on MT4 and Error 4756 (Invalid Price) on MT5.

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

LicenseID,newsltpshort,EURUSD,sl=1.12345 (price)
LicenseID,newsltpshort,EURUSD,sl=1,tp=2 (percentage)

LicenseID,newsltpshort,EURUSD,sl=0 (breakeven)

💡

Pips With sl=10, EA will compute your SL 10 pips away from the current market price. Percentage With sl=1, EA will compute your SL 1% away from the current market price.

💡

Move SL to Breakeven To move the SL of all your sell positions for the specified symbol to breakeven, indicate sl=0.

💡

Required Conditions

Position is in profit
Current market price is sufficiently far from the entry price

If either of the conditions are not met, sending in a “newsltpshort” with sl=0 will result in the Error 130 on MT4 and Error 4756 (Invalid Price) on MT5.

closelongpct

Close a percentage of buy positions (based on your initial volume), using 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 initial volume), using 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=

💡

required parameter for all pending orders such as buystop and buylimit

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

💡

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