PineConnector v3
Getting StartedSetup
Expert AdvisorAlerts
Test Alert
Low-code Alert
No-code AlertMessage Structure
Syntax
Debugging
Errors
TriggerOthers
FAQ
Roadmap
Free Scripts Library
SuperTrend StrategyCheatsheet
EA Settings affecting Syntax
Syntax Settings
Component | Description | Syntax | Options | Explanation |
Target Type | Determines how sl= and tp= targets are computed. | sl=, tp= | Pips
Price
Percentage | SLTP placed x pips from current market price
SLTP placed at price indicated (not recommended, quote differences).
SLTP placed x percent from current market price (1% → sl=1). |
Volume Type | Determines how volume is computed. | risk= | Lots
Dollar
% of Balance, Lots
% of Balance, Margin
% of Balance, Loss | Volume opened will be as indicated.
Dynamic — if trade hits SL, risk= value is lost. (sl= required)
Dynamic — 0.1 lot on $1000 account, 1 lot on $10,000, etc.
Dynamic — “risk=1” will increase margin used by 1%
Dynamic — if SL is hit, "risk=1" means losing 1% of balance (sl= required). |
Pending Order Entry | Determines how your pending order’s (PO) entry price is computed. SLTPs are computed based on the Target Type. | price= | Pips
Price
Percentage | Sets PO at a specified number of pips away from current market price.
Sets PO at a specified price from TradingView alert (not recommended).
Sets PO at a specified percentage from current market price. |
Account Filter | Determines the basis of the Account Filter. | accfilter= | Balance
Equity
Free Margin
Margin % | Signal processed if balance > $x.
Signal processed if equity > $x.
Signal processed if free margin > $x.
Signal processed if margin % > x (if no trade open, signal to process). |
Syntax
Basics
Component | Definition | Example |
License ID | Unique identifier found in the Licensing Dashboard. | 6012345678910 |
Commands | Actions like “buy” and “sell” with no equal (=) sign. | buy, sell, eaoff, closelong, buystop, cancellong |
Symbol | Asset or instrument to be traded → refer to Symbol List (CTRL+U). | EURUSD, NAS100, XAUUSD |
Others | Additional components with equal (=) sign such as “risk=”. | sl=, tp=, comment=, price=, spread= |
Market Orders
Component | Description | Example |
buy | Place a buy order at the market. Alternatives → long/bull/bullish. | LicenseID,buy,EURUSD,risk=0.011 |
sell | Place a sell order at the market. Alternatives → short/bear/bearish. | LicenseID,short,DAX30,risk=2 |
risk= | Required for all entry commands. | LicenseID,buy,EURUSD,risk=0.01 |
sl= | Place stop-loss. | LicenseID,buy,EURUSD,risk=1,sl=10.5 |
tp= | Place take-profit. | LicenseID,buy,EURUSD,risk=1,tp=15 |
comment= | Add a string into the order’s comment section. Invalid → ( / ) and ( = ) | LicenseID,buy,EURUSD,risk=1,comment="Strategy 1" |
eaoff | Halts the PineConnector EA. 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 |
closeall | Close all positions and orders, regardless of symbol.
Symbol → symbol where the EA is running on. | LicenseID,closeall,EURUSD |
closealleaoff | Close all positions and orders, and off/halt the PineConnector EA.
Symbol → symbol where the EA is running on. | LicenseID,closealleaoff,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,risk=1 |
closeshortsell | Close all sell positions and open a new sell. | LicenseID,closeshortsell,EURUSD,risk=1 |
newsltplong | Modify the SL and TP of the buy positions. Indicate “sl=0” to move SL to breakeven. | LicenseID,newsltplong,EURUSD,sl=1.12345 |
newsltpshort | Modify the SL and TP of the sell positions. Indicate “sl=0” to move SL to breakeven. | LicenseID,newsltpshort,EURUSD,tp=20 |
closelongpct | Close buy positions partially (25%, 34%, or 50%) based on initial volume. | LicenseID,closelongpct,EURUSD |
closeshortpct | Close sell positions partially (25%, 34%, or 50%) based on initial volume. | LicenseID,closeshortpct,EURUSD |
closelongvol | Close buy positions up to “risk=” value. | LicenseID,closelongvol,risk=3 |
closeshortvol | Close sell positions up to “risk=” value. | LicenseID,closeshortvol,risk=0.5 |
accfilter= | Account requirement for entering a position based on EA option selected. | LicenseID,buy,EURUSD,risk=1,accfilter=500 |
spread= | Maximum allowable spread in pips to enter a position. | LicenseID,buy,EURUSD,spread=2.1 |
Pending Orders
Component | Description | Example |
price= | Determines where the pending order is placed. Required parameter for all pending orders. Computation is per EA “Pending Order Entry” Option. Values > 0. | LicenseID,buystop,EURUSD,price=10,risk=1
LicenseID,selllimit,EURUSD,price=1.2345,risk=1 |
buystop | Place buy stop order above current market price. | LicenseID,buystop,EURUSD,price=10,risk=1 |
buylimit | Place buy limit order below current market price. | LicenseID,buylimit,EURUSD,price=10,risk=1 |
sellstop | Place sell stop order below current market price. | LicenseID,sellstop,EURUSD,price=10,risk=1 |
selllimit | Place sell limit order above current market price. | LicenseID,selllimit,EURUSD,price=10,risk=1 |
cancellong | Cancel all long orders. | LicenseID,cancellong,EURUSD |
cancelshort | Cancel all short orders. | LicenseID,cancelshort,EURUSD |
cancellongbuystop | Cancel all long orders and place a buystop order. | LicenseID,cancellongbuystop,EURUSD,risk=1,price=10 |
cancellongbuylimit | Cancel all long orders and place a buylimit order. | LicenseID,cancellongbuylimit,EURUSD,risk=1,price=10,sl=15 |
cancelshortsellstop | Cancel all short orders and place a sellstop order. | LicenseID,cancelshortsellstop,EURUSD,risk=1,price=10,tp=20 |
cancelshortselllimit | Cancel all short orders and place a selllimit order. | LicenseID,cancelshortselllimit,EURUSD,risk=1,price=10 |
newsltpbuystop | Modify the SL and TP of buystop orders. New SLTP per selected Target Type. | LicenseID,newsltpbuystop,EURUSD,sl=30,tp=60 |
newsltpbuylimit | Modify the SL and TP of buylimit orders. New SLTP per selected Target Type. | LicenseID,newsltpbuylimit,EURUSD,sl=10 |
newsltpsellstop | Modify the SL and TP of sellstop orders. New SLTP per selected Target Type. | LicenseID,newsltpsellstop,EURUSD,tp=20 |
newsltpselllimit | Modify the SL and TP of selllimit orders . New SLTP per selected Target Type. | LicenseID,newsltpselllimit,EURUSD,sl=10 |
Breakeven — moving SL to breakeven (profit = $0) after a number of pips, integers only.
Parameter | Description | Example | Interpretation |
betrigger | Breakeven will be activated after the position gains this number of pips. betrigger > 0. | betrigger=10 | Breakeven feature to trigger after price moves 10 favourable pips. |
beoffset | Safeguard some profit in pips. beoffset < betrigger. | beoffset=2 | New SL to be placed 2 pips above entry price for a buy. |
Pips Trailing — constantly move SL in the direction of the trade based on pips, integers only.
Parameter | Description | Example | Interpretation |
trailtrig | Trailing stop-loss will be activated after a trade gains this number of pips. | trailtrig=12 | First instance of trailing SL will be when price moves favourably for 12 pips. |
traildist | Distance of the trailing stop-loss from current price. | traildist=8 | SL will be placed 8 pips lower from current price. |
trailstep | Moves trailing stop-loss once price moves to favourable by a specified number of pips. | trailstep=3 | Subsequent trailing SL occurs after every 3 favourable pips. |
ATR Trailing — constantly move SL in the direction of trade based on ATR, integers only.
Parameter | Description | Example | Interpretation |
atrtimeframe | ATR Trailing Stop will be based on the specified timeframe in minutes. Allowable values are 1, 5, 15, 30, 60, 240 and 1440. | atrtimeframe=60 | ATR Trailing will be based on 60-min candles. |
atrperiod | Candles to average out for ATR. | atrperiod=14 | ATR computed using the average of the previous 14 candles. |
atrmultiplier | Multiple of ATR to utilise in the new SL computation. | atrmultiplier=2 | Average of the atrperiod to be multiplied by 2. |
atrshift
(optional, default: 0) | Relative shift of price information, 0 uses latest candle, 1 uses second last, etc. | atrshift=0 | ATR to use from the latest candle. |
atrtrigger | Activate the trigger of ATR Trailing after market moves favourably by a number of pips. | atrtrigger=8 | ATR Trailing will begin after 8 pips of favourable move. |
EA Settings not affecting Syntax
General Settings
Feature | Options | Description |
Pyramiding | On
On — Symbol & Direction in Profit
Off — 1 Buy or 1 Sell
Off — 1 Buy and 1 Sell | All incoming trades will open without restrictions.
An incoming trade will only open if profit of symbol and direction is more than $0.
Opposite trade won't open if trade is open, either 1 Buy or 1 Sell will exist.
Opposite trade will open if trade is open, max of 1 Buy and 1 Sell per symbol. |
Close on Reverse | On — Hedging
On — Netting
Off | Open positions will be closed, opposite trade will open.
Open positions will be closed without opening the opposite trade.
Incoming signals will not affect open positions. |
Shadow Targets | On
Off | SL and TP targets will be hidden and placed 100 pips further. (sl=, tp= required)
SL and TP targets will not be hidden. |
Partial Close % | 25%
34%
50% | Closes in 4 parts. The EA will round the nearest volume permitted.
Closes in 3 parts. The EA will round the nearest volume permitted.
Closes in 2 parts. The EA will round the nearest volume permitted. |
Max Open Positions | 0
>0 | EA does not limit open position count.
EA limits open position count accordingly. |
Max Open Positions
per Symbol | 0
>0 | EA does not limit open position count per symbol.
EA limits open position count per symbol. |
Account Settings
Feature | Options | Description |
Daily Profit | 0
0 < x ≤ 1
> 1 | Off, daily profit feature inactive.
Percentage, target of x% from start-of-day balance GMT+0. For 5% target, use 0.05.
Dollar, target of x dollars increase from start-of-day balance GMT+0. For $100 target, use 100. |
Daily Loss | 0
0 < x ≤ 1
> 1 | Off, daily loss feature inactive.
Percentage, tolerance of x% from start-of-day balance GMT+0. For 5% loss limit, use 0.05.
Dollar, tolerance of x dollars from start-of-day balance GMT+0. For $100 loss limit, use 100. |
Action (1) | Halt EA
Close All Positions
Close All Positions & Halt EA | PineConnector EA halts for the day.
Close all open market and pending orders.
Close all open market and pending orders, PineConnector EA halts for the day. |
Cumulative Profit | 0
0 < x ≤ 1
> 1 | Off, cumulative profit feature inactive.
Percentage, target of x% from total deposits and credits. For 25% target, use 0.25.
Dollar, target of x dollars from total deposits and credits. For $1000 target, use 1000. |
Cumulative Loss | 0
0 < x ≤ 1
> 1 | Off, cumulative loss feature inactive.
Percentage, tolerance of x% from total deposits and credits. For 15% loss limit, use 0.15.
Dollar, tolerance of x dollars from total deposits and credits. For $1000 loss limit, use 1000. |
Action (2) | Halt EA (Day)
Halt EA (Persistent)
Close All Positions
Close All Positions and Halt EA (Day)
Close All Positions and Halt EA (Persistent) | Halts EA for the day, auto-restarts next day.
Halts EA indefinitely until resumed.
Closes all open and pending orders.
Closes orders and halts EA for the day.
Closes orders and halts EA indefinitely. |
Miscellaneous Settings
Feature | Options | Description |
EA Magic Number | 76, 77, 78, 79, 80 | Determines the EA's magic number. |
Magic Restriction | On, Off | Determines whether EA restricts commands (closelong, etc) with the same Magic Number. |
Show Halt Button | On, Off | Determines whether the EA halt button is printed on the chart. |
Broker Set | A (default), B, C | Changes internal settings of the EA (MT5 EAs only). |
On-Chart Details | Concise, Comprehensive, License only, Terminal | Determines the amount of EA and license details printed on the chart. |
EA Active Hours | From 00:00 to 24:00 in HH:MM format | Have the EA operate only on selected hours based on broker time. |
Prefix & Suffix | Any string | Adds to before (prefix) or after (suffix) your symbol. |
Others:
‣
Step | Action |
1 | Download PineConnector EA from members area. |
2 | Access the Experts Folder in MetaTrader 4. |
3 | Add PineConnector EA to the Experts folder. |
4 | Allow DLL imports in MetaTrader 4. |
5 | Enable Auto Trading in MetaTrader 4. |
6 | Attach PineConnector EA to a chart in MetaTrader 4. |
7 | Allow live trading and DLL imports in MetaTrader terminal. |
8 | Input License ID in PineConnector EA. |
9 | Check Connection to PineConnector server. |
‣
Step | Action |
1 | Download PineConnector EA from members area. |
2 | Access Experts Folder in MetaTrader 5. |
3 | Add PineConnector EA to Experts folder. |
4 | Enable DLL imports in MetaTrader 5. |
5 | Ensure "Algo Trading" is enabled. |
6 | Attach PineConnector EA to chart. |
7 | Enable Algo Trading and DLL imports in PineConnector EA. |
8 | Input License ID in PineConnector EA. |
9 | Check Connection to PineConnector server. |
‣
Step | Action | Description |
1 | Find the Symbol | Open Symbol List (CTRL+U) and locate "EURUSD".
Note: broker may have different name such as EURUSD.i |
2 | Create a TradingView Alert | Create alert → shortcut: Alt+A (Windows) or Option+A (Mac). |
3 | Configure the Alert | Set condition: "Greater Than", Value: 0
Webhook URL: https://pineconnector.net/webhook/
Message: LicenseID,buy,symbol,risk=1
Replace: LicenseID and change symbol. |
4 | Verify Alert Triggers | Check Alerts Log for triggered alert. |
5 | Confirm Signal Receipt | Check members area for new signal entry with timestamp. |
6 | Confirm Trade Execution | Check MetaTrader "Trade" tab for executed buy order of 1 lot of EURUSD. |
‣
- To enhance reliability and minimize time between signal and trade execution, utilize a Virtual Private Server (VPS).
- Access the Experts tab in your MetaTrader terminal by pressing F7.
- Limit yourself to only one instance of the PineConnector EA per License ID.
- With one instance of PineConnector EA, you can trade all symbols available in your Symbol List (CTRL+U).
- When testing new configurations or syntax in your EA, utilize manual alerts for evaluation.
- Continuously monitor the Experts tab for an understanding of how the EA processes your alerts.
- Create alerts on TradingView by pressing Alt+A (Windows) or Option+A (Mac).
- Considering there are quote differences between TradingView and your MT4/5 broker, use pips and percentage target types. 1. For enhanced trading potential, we recommend using a broker with TradingView datafeed and accessibility on MetaTrader such as this.
- When reporting bugs, accompany your report with a screenshot of the Experts output to facilitate prompt review.
- Prior to implementing a new script or set of EA settings in live trading, run a demo test first.