FRZ Pine Meta Connector – User Manual

FRZ Pine Meta Connector – User Manual

• Related Product: FRZ Pine Meta Connector
• Browse Similar Tools: Indicator Automation Tools

• Video Guide
• Before You Start
• WebRequest Setup
• Installation
• TradingView Alert Setup
• Demo Version
• Quick Specifications
• On-Chart Panel
• Input Settings
• Alert Message Format
• Example Alerts
• SL/TP from Your Strategy or Indicator
• Set Files
• Troubleshooting
• Support Links

Video Guide

(This is from an older version – always consider the written text below as the updated guide. A new video is planned.)

Before You Start

• You need a TradingView plan that includes webhook alerts (the free TradingView plan does not have webhooks).
• You need your personal API key. It is sent to you after purchase. The same key goes into the EA and into every TradingView alert.
• The full version requires a valid license for your trading account number. The DEMO version needs no license but works on demo accounts only.
• Enable Algo Trading (MT5) / AutoTrading (MT4) in your platform, otherwise every signal fails with “AutoTrading is disabled”.
• Allow WebRequest for http://167.86.99.208 and https://frzserver.com (see the next section). If the email you received after purchase gives a different server address, use that one instead.
• Attach the EA to one chart only, in one terminal per account. It trades every symbol your alerts send, whatever chart it is on. If you attach it to a second chart in the same terminal, the second copy shows “Another instance of FRZ Pine Meta Connector is already running on this terminal” and stops.
• Keep MetaTrader running (a VPS is recommended). Signals that arrive while the terminal is closed are not executed later – see setting 4.

WebRequest Setup

1. Open Tools > Options > Expert Advisors.
2. Enable Allow WebRequest for listed URL.
3. Add these two URLs, each on its own line: http://167.86.99.208 and https://frzserver.com
4. Click OK and attach (or re-attach) the EA.

Type the addresses exactly as shown – http:// (not https) for the IP address, and no path after it. If the first one is missing, the panel shows “Allow WebRequest for http://167.86.99.208 (Tools > Options > Expert Advisors)”. If frzserver.com is missing, the license cannot be checked and the full version does not start.

Installation

MT4 Installation

1. Download the MT4 version of the EA and unzip it.
2. In MT4 open File > Open Data Folder and copy the .ex4 file into MQL4/Experts.
3. Restart MT4, or right-click Expert Advisors in the Navigator panel and select Refresh.
4. Drag the EA onto any one chart (any symbol, any timeframe).
5. On the Inputs tab paste your API key into setting 1, adjust the other settings, then click OK.
6. Enable AutoTrading on the toolbar. The panel should turn green: “Connected – waiting for signals”.

MT5 Installation

1. Download the MT5 version of the EA and unzip it.
2. In MT5 open File > Open Data Folder and copy the .ex5 file into MQL5/Experts.
3. Restart MT5, or right-click Expert Advisors in the Navigator panel and select Refresh.
4. Drag the EA onto any one chart (any symbol, any timeframe).
5. On the Inputs tab paste your API key into setting 1, adjust the other settings, then click OK.
6. Enable Algo Trading on the toolbar. The panel should turn green: “Connected – waiting for signals”.

MT5 works on both hedging and netting accounts. On a netting account MT5 keeps one position per symbol, so an opposite alert (e.g. a sell while you hold a buy) reduces or reverses that position instead of opening a second trade.

When the EA starts it also changes the chart to the standard FRZ colours (grey background, coloured candles) so the panel is easy to read.

TradingView Alert Setup

1. On your TradingView chart click Alert (the clock icon) and choose the condition – a price level, an indicator, or your strategy (“Order fills” for a strategy).
2. Click the Message row and replace its text with the JSON alert message, for example: {"apiKey":"YOUR_API_KEY","symbol":"{{ticker}}","action":"buy","sl":20,"tp":40,"lot":0.1} – with your own API key. The message must contain only the JSON, with nothing before or after it.
3. Click the Notifications row, tick Webhook URL and enter http://167.86.99.208/webhook
4. Click Create.

When the alert fires, the trade normally appears in MetaTrader within 2-3 seconds, and the panel’s “Last:” line shows the result. All message formats are listed in Alert Message Format and Example Alerts.

Demo Version

The DEMO version is for trying the connector with real TradingView alerts on a demo account. Its limits:

• Works on demo accounts only. On a real account it shows “FRZ Pine Meta Connector DEMO works on demo accounts only” and does not start.
• No license is required.
• Uses the shared DEMO API key, which is already filled into setting 1. Use the same key in your TradingView alerts. Because the key is shared, other demo users’ alerts can also reach your demo account.
• Every trade and pending order it opens is closed 5 minutes after opening.
• After 10 minutes it closes everything it opened, shows “FRZ Pine Meta Connector DEMO stopped after 10 minutes (DEMO limit)” and removes itself from the chart. Attach it again to keep testing.
• The last panel line shows the limits and a countdown, e.g. “DEMO: trades close after 5 min, EA stops in 7 min”.

The full version has none of these limits and uses your own private API key.

Quick Specifications

On-Chart Panel

The EA draws a dark panel in the top-left corner of the chart. It refreshes every second.

Every signal is also written to the Experts tab, e.g. “FRZ Pine Meta Connector: signal #57 buy EURUSD: done (0.10 lots EURUSD) ticket 123456”.

Input Settings

Pips: sl, tp and the trailing step are in pips. On 5- and 3-digit symbols (e.g. EURUSD 1.10003, USDJPY 150.003) 1 pip = 10 points. On other symbols (e.g. gold quoted 2375.50) 1 pip = 1 point = the last price digit, so “sl”:250 on gold is 2.50 in price.

Alert Message Format

Every alert message is a JSON object – field names in double quotes, text values in double quotes, numbers without quotes.

If a stop loss or take profit is closer to the price than your broker allows, the EA moves it out to the broker’s minimum distance and notes “SL widened to the broker minimum distance” in the result. If your broker refuses stops on the opening order, the EA opens the trade first and then sets the stops.

Not supported yet: moving an existing trade’s stop loss to breakeven by alert, modifying an open trade’s SL/TP by alert, and partial closes.

Example Alerts

Replace YOUR_API_KEY with your own key.

1) Market Orders

1.1 Market Buy (lot size from the EA settings)

{
"apiKey": "YOUR_API_KEY",
"symbol": "{{ticker}}",
"action": "buy"
}

1.2 Market Buy with lot size

{
"apiKey": "YOUR_API_KEY",
"symbol": "EURUSD",
"action": "buy",
"lot": 0.05
}

1.3 Market Sell with SL/TP in pips

{
"apiKey": "YOUR_API_KEY",
"symbol": "EURUSD",
"action": "sell",
"sl": 20,
"tp": 40
}

1.4 Market Buy with exact SL/TP prices

{
"apiKey": "YOUR_API_KEY",
"symbol": "EURUSD",
"action": "buy",
"sl_price": 1.0820,
"tp_price": 1.0880
}

1.5 Market Buy with risk:reward (TP = SL x 3)

{
"apiKey": "YOUR_API_KEY",
"symbol": "GBPUSD",
"action": "buy",
"sl": 25,
"tp_multiplier": 3
}

2) Pending Orders

2.1 Buy Limit

{
"apiKey": "YOUR_API_KEY",
"symbol": "EURUSD",
"action": "buy_limit",
"price": 1.0950,
"sl": 20,
"tp": 40
}

2.2 Sell Limit

{
"apiKey": "YOUR_API_KEY",
"symbol": "XAUUSD",
"action": "sell_limit",
"price": 2375.50,
"sl": 250,
"tp": 500
}

2.3 Buy Stop

{
"apiKey": "YOUR_API_KEY",
"symbol": "GBPUSD",
"action": "buy_stop",
"price": 1.2800,
"sl": 30,
"tp": 60
}

2.4 Sell Stop

{
"apiKey": "YOUR_API_KEY",
"symbol": "BTCUSD",
"action": "sell_stop",
"price": 118000,
"sl": 400,
"tp": 800
}

A pending order price must be on the correct side of the market (a buy limit below the current price, a buy stop above it), otherwise the broker refuses it with “invalid price”.

3) Trade Management

3.1 Close all trades (only the EA’s trades, unless setting 10 says all trades)

{
"apiKey": "YOUR_API_KEY",
"action": "close_all"
}

3.2 Close the trades of one symbol

{
"apiKey": "YOUR_API_KEY",
"symbol": "EURUSD",
"action": "close_symbol"
}

3.3 Close only the buys (or sells) of one symbol

{
"apiKey": "YOUR_API_KEY",
"symbol": "EURUSD",
"action": "close_side",
"side": "buy"
}

3.4 Close the trades with a magic number

{
"apiKey": "YOUR_API_KEY",
"action": "close_magic",
"magic": 1001
}

3.5 Cancel all pending orders

{
"apiKey": "YOUR_API_KEY",
"action": "cancel_pending_all"
}

3.6 Cancel the pending orders of one symbol

{
"apiKey": "YOUR_API_KEY",
"symbol": "GBPUSD",
"action": "cancel_pending_symbol"
}

If there is nothing to close or cancel, the result is “nothing to close” / “nothing to cancel” – that is not an error.

SL/TP from Your Strategy or Indicator

TradingView can insert values from your strategy or indicator into the alert message, so stops do not have to be fixed numbers.

Example A – pip distances from plotted values

{
"apiKey": "YOUR_API_KEY",
"symbol": "{{ticker}}",
"action": "{{strategy.order.action}}",
"sl": {{plot_0}},
"tp": {{plot_1}}
}

Example B – exact SL/TP prices from plotted values

{
"apiKey": "YOUR_API_KEY",
"symbol": "{{ticker}}",
"action": "{{strategy.order.action}}",
"sl_price": {{plot_0}},
"tp_price": {{plot_1}}
}

• {{ticker}} – replaced with the chart’s symbol (e.g. EURUSD).
• {{strategy.order.action}} – becomes “buy” or “sell” from your strategy’s order. Only strategies have this placeholder, not indicators.
• {{plot_0}}, {{plot_1}} – the values of the first and second plot of your script (e.g. a stop-loss line and a target line).
• Use sl / tp when your script outputs pip distances, and sl_price / tp_price when it outputs prices.

Pine Script example – strategy that sends its own alerts

This EMA-cross strategy places the stop loss at the lowest low (buys) or highest high (sells) of the last 5 candles and the take profit at 2x the risk. It sends the alert message itself with alert(), so create the TradingView alert with the condition “alert() function calls only” and the webhook URL – the Message box is not used. Inside alert() TradingView does not fill in {{...}} placeholders, so the script uses syminfo.ticker for the symbol.

//@version=5
strategy("EMA Cross with SL/TP Alerts", overlay=true, margin_long=100, margin_short=100)

emaFast = ta.ema(close, 10)
emaSlow = ta.ema(close, 20)
longCond  = ta.crossover(emaFast, emaSlow)
shortCond = ta.crossunder(emaFast, emaSlow)

longSL  = ta.lowest(low, 5)
shortSL = ta.highest(high, 5)
longTP  = close + (close - longSL) * 2
shortTP = close - (shortSL - close) * 2

if (longCond)
    strategy.entry("Long", strategy.long)
    alert('{"apiKey":"YOUR_API_KEY","symbol":"' + syminfo.ticker + '","action":"buy","sl_price":' + str.tostring(longSL) + ',"tp_price":' + str.tostring(longTP) + '}', alert.freq_once_per_bar_close)

if (shortCond)
    strategy.entry("Short", strategy.short)
    alert('{"apiKey":"YOUR_API_KEY","symbol":"' + syminfo.ticker + '","action":"sell","sl_price":' + str.tostring(shortSL) + ',"tp_price":' + str.tostring(shortTP) + '}', alert.freq_once_per_bar_close)

plot(emaFast, color=color.orange)
plot(emaSlow, color=color.blue)

Set Files

FRZ Pine Meta Connector does not use .set files. What it trades is decided by your TradingView alerts, and settings such as the lot size, magic number and symbol mapping depend on your own account and broker, so a fixed .set file would not reflect the correct values for your account. Use the Input Settings table above as your starting configuration instead.

Troubleshooting

Get Support

Online AI chat: https://t.me/FRZSupportBot
Discord Forum: https://www.frzsoftware.com/discord

Useful Links

Recommended VPS: https://www.frzsoftware.com/getvps
Join VIP Club: https://www.frzsoftware.com/vipclub
Social Links: https://www.frzsoftware.com/socials

Disclaimer

Our software is provided “as is”, without any warranty or condition of any kind, express, implied or statutory. You are advised to do necessary testing on demo accounts before using the software on a live account. Trading carries a high level of risk to your capital and you should only trade with money you can afford to lose. Past performance of any trading system is not necessarily indicative of future results.