TV Bridge
Connect TradingView alerts to MT5 or cTrader
How TV Bridge works
TV Bridge turns your TradingView alerts into real trades on your MT5 or cTrader account. When your chart or strategy fires an alert, TradingView sends a webhook to LOTUX; LOTUX authenticates it with your secret, applies your risk rules, and places the order.
It is built around market orders (buy / sell), pending orders (limit / stop), and closing positions (close / close all), with a guided builder for each. For the full action set — including modifying open positions and partial closes — see the External Signals app.
You send these as webhook alerts from TradingView — set webhook alerts up in your TradingView account (see TradingView's own alerts guide for how). LOTUX carries out the instructions you send — it is not a broker and not investment advice.
Setup guide
Connect TradingView to your account in four steps:
- In LOTUX, open the TV Bridge app for your trading account and copy your webhook URL and your secret.
- In TradingView, create an alert, open the Notifications tab, tick "Webhook URL", and paste your LOTUX webhook URL.
- In the alert's Message box, paste a JSON message that includes your secret and the trade (the app has a guided builder — see Alert templates).
- Save and enable the alert. When it fires, the trade appears on your account.
Tip: use the guided builder in the TV Bridge app to produce a correct message before you enable the alert.
Alert templates
The TradingView alert Message is JSON. It always includes your secret and a type; entries also need a symbol and volume.
{
"secret": "YOUR_SECRET",
"type": "buy",
"symbol": "XAUUSD",
"volume": 0.1,
"sl": 1900.00,
"tp": 1950.00
}| Field | When | Notes |
|---|---|---|
| secret | always | Your TV Bridge secret (copy from the dashboard). |
| type | always | Market: buy / sell. Pending: buy_limit / sell_limit / buy_stop / sell_stop. Closing: close / close_all. |
| symbol | entries | e.g. EURUSD, XAUUSD (auto-uppercased). |
| volume | entries | Lot size, e.g. 0.1. |
| price | pending | Entry price for a limit / stop order. |
| sl / tp | optional | Stop-loss / take-profit price. |
| alertId | optional | An id to safely de-duplicate repeated alerts. |
Pending order (limit / stop) — set type to the pending action and include a price:
{
"secret": "YOUR_SECRET",
"type": "buy_limit",
"symbol": "EURUSD",
"volume": 0.1,
"price": 1.0800
}Dynamic alerts — use TradingView placeholders so one alert works for any signal your strategy produces:
{
"secret": "YOUR_SECRET",
"type": "{{strategy.order.action}}",
"symbol": "{{ticker}}",
"volume": {{strategy.order.contracts}}
}- {{strategy.order.action}} — becomes buy or sell from your Pine strategy.
- {{ticker}} — the chart symbol.
- {{strategy.order.contracts}} — the position size from your strategy.
- {{strategy.order.price}} / {{close}} — price values you can pass through.
To target one specific account, add "accountId": "<your account>" (its UUID or MT login) to the message; otherwise the signal goes to every active account linked to that secret.
Troubleshooting
- "Invalid secret" (401) — the secret is wrong, or you used a secret from a different app. Copy the TV Bridge secret for the correct account.
- Too many requests (429) — alerts are firing faster than the rate limit; slow the alert down.
- No trade appears — check that your account is connected and online (your MT5 / cTrader terminal / EA); a disconnected account cannot receive the order.
- Wrong symbol — symbols are uppercased automatically, but they must match what your broker uses (for example XAUUSD vs GOLD).
- A pending order does nothing — a limit / stop order needs a price in the message.
- After you rotate your secret — update the secret inside your TradingView alert message, or it will fail with 401.
- No webhook option in TradingView — make sure webhook alerts are enabled in your TradingView account (see TradingView's alerts guide).