Documentation

Everything you need to set up MetaSync and start automating your TradingView strategies on MT5.

🚀 Getting Started 📝 Alert Syntax ⚙ Settings Guide 🛡️ SL Management 🔧 Troubleshooting 💬 Contact Support

Getting Started

Step 1: Install MetaSync

Download the installer from the download page
Run the installer and follow the on-screen instructions
Launch MetaSync from your desktop or Start menu

Step 2: Activate Your License

Enter your license key when prompted on the login screen. Your license is bound to your machine's Hardware ID upon first activation.

Step 3: Connect MT5

Go to Settings tab
Enter your MT5 Login ID, Password, and Server name
Set your MT5 Terminal Path (e.g., C:\Program Files\MetaTrader 5\terminal64.exe)
Click Test MT5 Connection to verify
Click Save Settings

Step 4: Start the Server & Copy Webhook

Click Start Server in the top-right corner
Your secure webhook URL will appear on the Dashboard
Copy the URL and paste it into your TradingView alert's Webhook URL field

Alert Syntax

MetaSync accepts JSON payloads from TradingView webhooks. Here's the basic format:

{
  "action": "buy",
  "symbol": "EURUSD",
  "lot_size": 0.1,
  "sl_mode": "none",
  "secret": "YOUR_SECRET"
}

Available Actions

buy — Open a buy position
sell — Open a sell position
close_buy — Close all buy positions for the symbol
close_sell — Close all sell positions for the symbol
close_all — Close all open positions

Optional Fields

lot_size — Trade size (default: your Settings default)
sl_percent — Stop loss as percentage
tp_percent — Take profit as percentage
sl_mode — SL management mode (see below)
secret — Webhook secret for authentication

Use the built-in JSON Generator tab in MetaSync to generate copy-paste ready alerts without memorizing the syntax.

Settings Guide

MT5 Connection

Enter your MT5 broker credentials. Use the Test Connection button to verify before saving.

Webhook & Server

Server Port — Default is 8000. Change only if you have a conflict.
Webhook Secret — Optional. If set, incoming alerts must include a matching "secret" field in the JSON.

Trade Defaults

Set default lot size, SL%, TP%, expiry hours, and position monitor interval. These are used when an alert doesn't specify its own values.

SL Management Modes

None (Fixed SL) — SL stays exactly where you set it. No adjustments.
Breakeven — Moves SL to entry price once trade is in profit.
Simple Trail — Trails SL behind the price at a fixed distance.
Hybrid (Best) — Combines breakeven + trailing for optimal protection.

Troubleshooting

MT5 Connection Fails

Make sure MT5 is installed and the terminal path is correct
Ensure your MT5 broker allows algo trading
Check that your login, password, and server name are correct

Webhooks Not Received

Verify that the server is started (green "Connected" status)
Copy the webhook URL exactly — including https://
Ensure your TradingView plan supports webhooks (Essential or higher)

Need More Help?

Contact our support team by submitting a ticket on our Support Page.