Sign In Start Trial

Synnectra Documentation

TradingView to MetaTrader automation documentation.

Set up the Synnectra EA, send TradingView webhook alerts, control risk, map broker symbols, and monitor execution from the same dashboard language used across the product.

Start setup View alert examples
5 min setup path /webhook endpoint BUY, SELL, CLOSE actions
Quick setup Alert syntax Secret key Troubleshooting

Start here

Quick Start

The shortest reliable path is account, EA, License ID, TradingView webhook, then dashboard monitoring.

01

Create your account

Register, open the dashboard, and copy your License ID. The License ID routes TradingView alerts to the correct trading account.

Create account
02

Download the EA

Use the dashboard download module to get the Synnectra EA package. The package includes the files required by the current release.

Open dashboard
03

Install in MetaTrader

Place the EA in MQL5/Experts, attach it to a chart, paste the License ID, and enable algo trading.

04

Create the alert

Set the TradingView webhook URL to https://synnectra.com/webhook and add a supported message body.

05

Monitor execution

Use Active Accounts, Performance, Risk Management, News Events, and Notifications to see what happened and why.

TradingView sends the alert to Synnectra first. Synnectra validates the license, optional secret, risk rules, symbol mapping, news state, and trading window before forwarding the signal to the EA.

Minimal authenticated alert 
LICENSE_ID,BUY,EURUSD,secret=WEBHOOK_SECRET

MetaTrader

EA Setup

The Synnectra Expert Advisor subscribes to your signal stream and reports account status back to the dashboard.

Installation checklist

  1. Download the latest EA package from the dashboard Download page.
  2. Open MetaTrader and select File > Open Data Folder.
  3. Copy the EA into MQL5/Experts. Copy bundled library files if the package includes them.
  4. Restart MetaTrader or refresh the Navigator panel.
  5. Drag Synnectra onto any chart and enable Allow Algo Trading.
  6. Paste your dashboard License ID into InpLicenseID.

Required EA input

InpLicenseID is the account identifier shown in the dashboard. It is used as the ZeroMQ subscription topic so the EA only receives signals for that account.

EA setup reference
Item Value Purpose
InpLicenseID Dashboard License ID Routes only your Synnectra signals to this EA instance.
Algo Trading Enabled Allows the EA to open, close, and manage orders.
WebRequest Allowed when prompted Lets the EA report heartbeats, balances, pip values, and trade status.

If the dashboard shows the account as offline, check the MT5 Experts tab first. Connection, WebRequest, and symbol availability errors are logged there by the EA.

Workspace

Dashboard Overview

The dashboard is the control plane for connected accounts, signal security, mappings, risk, notifications, and execution review.

Active Accounts

Review connection state, balance, platform, License ID, copy-trading grouping, and account-specific sizing.

Signal Authentication

Generate, copy, recycle, or disable the webhook secret that TradingView alerts can include as secret=.

Symbol Mapping

Translate TradingView symbols to broker-specific symbols like EURUSDm, XAUUSD.raw, or index aliases.

Performance

Track executed trades, P&L, win rate, drawdown, journal history, and latency reports.

Risk Management

Set max positions, per-symbol caps, daily loss limits, daily profit locks, and emergency guardrails.

Notifications

Send execution, error, connection, and report notifications through supported channels such as Email, Telegram, and Discord.

Webhook messages

Full Syntax Reference

Synnectra accepts comma-separated alert bodies inspired by PineConnector syntax.

Format 
LicenseID,Action,Symbol[,key=value,...]

Required fields

Position Field Description
1 LicenseID Your account License ID from the dashboard.
2 Action BUY, SELL, CLOSE, or CLOSEALL.
3 Symbol TradingView symbol before mapping. Use ALL as the placeholder for CLOSEALL.

Parsing rules

  • Fields are split by commas.
  • Action and symbol are normalized to uppercase.
  • Optional parameters can appear in any order after the symbol.
  • Do not put commas inside parameter values.
  • Use the dashboard secret only in the alert body as secret=YOUR_SECRET.

Optional parameters

Key Aliases Use Example
vol_lots None Fixed lot size. vol_lots=0.10
vol_percent risk, vol_pct_bal_loss Risk percentage of account balance. Use with sl_pips for calculated sizing. vol_percent=1.5
vol_dollar None Fixed currency amount to risk. Use with sl_pips. vol_dollar=75
sl_pips sl Stop loss distance in pips from execution price. sl_pips=25
tp_pips tp Take profit distance in pips from execution price. tp_pips=50
sl_price None Absolute stop loss price. sl_price=1.08500
tp_price None Absolute take profit price. tp_price=1.09500
secret None Webhook secret from Signal Authentication. secret=WEBHOOK_SECRET
comment None Custom MT5 trade comment. comment=strategy_a
magic None Custom magic number. If omitted, the EA derives one from the License ID. magic=55555
betrigger None Break-even trigger distance in pips. betrigger=15

If no sizing parameter is sent, Synnectra uses the account sizing profile from the dashboard when available. Otherwise, it falls back to 1% risk where risk-based sizing is possible.

Examples

Syntax Examples

Replace LICENSE_ID and WEBHOOK_SECRET with your dashboard values.

Simple buy

Uses account default sizing and authenticates with the webhook secret.

TradingView alert 
LICENSE_ID,BUY,EURUSD,secret=WEBHOOK_SECRET

Sell with percent risk

Risks 2% of balance using the stop distance for calculated lot size.

TradingView alert 
LICENSE_ID,SELL,XAUUSD,vol_percent=2,sl_pips=50,tp_pips=100,secret=WEBHOOK_SECRET

Fixed lots with absolute exits

Uses a fixed lot size and exact broker price levels for SL and TP.

TradingView alert 
LICENSE_ID,BUY,GBPUSD,vol_lots=0.25,sl_price=1.25850,tp_price=1.26850,secret=WEBHOOK_SECRET

Dollar risk

Risks a fixed currency amount based on the stop distance.

TradingView alert 
LICENSE_ID,BUY,USDJPY,vol_dollar=100,sl_pips=25,tp_pips=50,secret=WEBHOOK_SECRET

Break-even trigger

Moves the stop to break-even after price moves by the configured pip distance.

TradingView alert 
LICENSE_ID,BUY,EURUSD,vol_percent=1,sl_pips=20,tp_pips=40,betrigger=10,secret=WEBHOOK_SECRET

Close one symbol

Closes open positions for the signal symbol and EA magic number.

TradingView alert 
LICENSE_ID,CLOSE,EURUSD,secret=WEBHOOK_SECRET

Close all

Uses ALL as the required symbol placeholder.

TradingView alert 
LICENSE_ID,CLOSEALL,ALL,secret=WEBHOOK_SECRET

Pine Script dynamic message

Build the alert body from strategy conditions and TradingView's active ticker.

Pine Script 
// Example body generated by your Pine Script logic
alertMessage = "LICENSE_ID,BUY," + syminfo.ticker + ",vol_percent=1,sl_pips=25,tp_pips=50,secret=WEBHOOK_SECRET"
alert(alertMessage, alert.freq_once_per_bar_close)

Risk amount

Position Sizing

Choose fixed lots when you know the exact order size, or risk-based sizing when Synnectra should calculate lots from stop distance and account value.

Fixed lots

Use vol_lots for an exact order size.

vol_lots=0.25

Balance percentage

Use vol_percent with sl_pips so Synnectra can calculate the lots.

vol_percent=1.5,sl_pips=30

Fixed currency risk

Use vol_dollar with sl_pips for a fixed risk amount.

vol_dollar=100,sl_pips=25

Recommended usage

  • Use vol_percent or vol_dollar when your alert includes sl_pips.
  • Use vol_lots when the strategy has already decided the exact lot size.
  • Configure account-level defaults in the dashboard for strategies that should omit sizing from the alert body.
  • Keep pip value mappings updated for symbols with non-standard broker contract specifications.

Exits

Stop Loss and Take Profit

Use pip distances for portable alerts, or absolute prices when your strategy calculates exact broker price levels.

Pip-based exits

The EA calculates the absolute price from live market data at execution time.

Pip exits 
LICENSE_ID,BUY,EURUSD,vol_percent=1,sl_pips=20,tp_pips=40,secret=WEBHOOK_SECRET

Absolute prices

Use exact prices if your strategy or broker feed already provides the levels.

Price exits 
LICENSE_ID,BUY,EURUSD,vol_lots=0.10,sl_price=1.08500,tp_price=1.09500,secret=WEBHOOK_SECRET

When both pip fields and absolute price fields are present, pip-based SL/TP fields should be treated as the active exit instructions.

Security

Signal Authentication

Signal authentication prevents unauthorized alert bodies from opening trades on your account.

How it works

  1. Open Active Accounts in the dashboard.
  2. Enable Signal Authentication to generate a secret key.
  3. Add secret=YOUR_SECRET to every TradingView alert body.
  4. Synnectra validates the secret before risk checks, mapping, and forwarding.
Authenticated alert 
LICENSE_ID,BUY,EURUSD,vol_percent=1,sl_pips=20,secret=WEBHOOK_SECRET

Recycling the secret invalidates the previous one immediately. Update every TradingView alert after recycling the key.

Broker symbols

Symbol Mapping

Map TradingView symbols to broker-specific symbols before the signal reaches the EA.

TradingView Symbol Broker Symbol Reason
EURUSD EURUSDm Broker suffix.
XAUUSD XAUUSD.raw Raw spread account naming.
US100 NAS100.cash Index CFD alias.

Setup

  1. Go to Symbol Mapping in the dashboard.
  2. Select the account the rule should apply to.
  3. Add the TradingView symbol and the broker symbol.
  4. Add a pip value override only when the broker contract needs it.

Market events

News Protection

News protection pauses new trades around high-impact events and can optionally coordinate account-level behavior from the dashboard.

Calendar sync

Synnectra tracks upcoming high-impact economic events used by the news module.

Auto pause

Signals can be rejected while news protection is active for the account.

Auto resume

Trading resumes after the configured buffer has passed.

Guardrails

Risk Management

Risk checks are applied before a qualifying signal is forwarded to the EA.

Control What it prevents
Max open positions Rejects new entries when the account already has too many open positions.
Max positions per symbol Prevents over-concentration on one market.
Max daily profit Locks the account once daily profit reaches the configured value.
Max daily loss percentage Stops entries after drawdown reaches the configured percentage.

CLOSE and CLOSEALL signals are treated differently from new entries because they reduce exposure.

Schedule

Trading Time Windows

Restrict trading to the sessions your strategy is designed for.

Session focus

Trade only London, New York, or another preferred liquidity window.

Overnight block

Reject entries during rollover, low liquidity, or broker maintenance periods.

Strategy cooldown

Use account windows alongside strategy rules for cleaner execution.

Multi-account

Copy Trading

A master account can route executions to subscriber accounts with account-specific sizing.

1 Signal reaches master

The TradingView alert is validated for the master account.

2 Synnectra applies copy rules

Subscriber accounts inherit the trade intent with their own sizing mode.

3 Subscribers execute

Each account receives its own routed command and reports execution back.

Subscriber sizing Behavior
Fixed Uses a fixed lot size per copied trade.
Proportional Scales from the master or account relationship.
Risk percent Calculates lots from subscriber balance and stop distance.

API security

EA Request Security

Webhook signal authentication and EA-side account routing are separate layers.

The public TradingView webhook is protected by License ID routing, rate limiting, and optional secret= validation. EA status endpoints can validate HMAC headers when present; current EA setup does not require manual HMAC configuration.

Reference

Troubleshooting

Start with the exact rejection message, then check the dashboard module that owns that rule.

EA not receiving signals
  • Confirm the EA is attached to a chart and algo trading is enabled.
  • Check the MT5 Experts tab for connection or WebRequest errors.
  • Verify InpLicenseID matches the account shown in the dashboard.
  • Confirm the alert body starts with the same License ID.
Invalid webhook secret
  • Include secret=YOUR_SECRET in the alert body.
  • Copy the current secret from the dashboard instead of using an old recycled key.
  • Disable Signal Authentication only if you understand the risk.
Max open positions reached
  • Review the account's Risk Management settings.
  • Close positions or raise the configured limit.
  • Use CLOSE or CLOSEALL if the strategy needs to reduce exposure.
Trading is currently disabled
  • The account is outside its trading time window.
  • Update the configured hours or wait for the next allowed session.
Trading paused due to news
  • News protection is active for a high-impact event.
  • Review the News Events page and any account-level exclusions.
Wrong symbol executed
  • Review Symbol Mapping for the account.
  • Confirm the broker symbol is visible in MT5 Market Watch.
Lot size is not what I expected
  • Check whether the alert uses fixed lots, percentage risk, dollar risk, or account defaults.
  • For calculated sizing, confirm sl_pips, account balance, and pip value.
  • Review any pip value override in Symbol Mapping.

FAQ

Frequently Asked Questions

Short answers to the questions that usually come up during setup.

What webhook URL should I use?

Use https://synnectra.com/webhook in the TradingView alert webhook field.

Is signal authentication required?

It is strongly recommended. When enabled, every alert must include the current secret= value from the dashboard.

Can I use multiple TradingView alerts with the same License ID?

Yes. Multiple alerts can target the same account as long as each message uses the correct License ID and secret when enabled.

Does the EA need to be on a specific chart?

No. The alert symbol determines the traded instrument. The EA can be attached to any chart as long as the broker symbol is available.

What brokers are supported?

Any broker supported by the connected MetaTrader terminal can work, provided the symbol exists and algo trading is allowed.

Is there a free trial?

Yes. New accounts can start with a 14-day free trial with full access.