TradingView webhook payload reference

The webhook accepts a single comma-separated line. There are two payload families: entry signals (open a new trade) and exit signals (close existing positions).

1. Entry signals (buy / sell)

Opens a new position. risk=N is optional (the account card's Risk% is used when omitted). tp and trail are mutually exclusive: use one or the other.

# Fixed take profit (uses account card's Risk%)
dashboardID,action,SYMBOL,sl=NN,tp=NN

# Fixed take profit with risk override
dashboardID,action,SYMBOL,sl=NN,tp=NN,risk=N

# Trailing stop, activate at 1x SL distance (uses account card's Risk%)
dashboardID,action,SYMBOL,sl=NN,trail=1

# Trailing stop, activate at 2x SL distance, with risk override
dashboardID,action,SYMBOL,sl=NN,trail=2,risk=N

Fields

• dashboardID: your dashboard ID. Standard webhook alerts broadcast to all eligible connected accounts on that dashboard.
• action: buy or sell.
• SYMBOL: exactly as the broker lists it (e.g. XAUUSD, EURUSD, US30).
• sl=NN: stop loss value. Interpreted as pips or absolute price depending on the EA's SL/TP input mode.
• tp=NN: take profit value, same units as sl. Use this for fixed take-profit trades. Mutually exclusive with trail.
• trail=N: activation multiplier (requires EA v1.6.0+). trail=1 activates the trailing stop once price moves 1× the sl distance into profit; trail=2 waits for 2×, trail=1.35 for 1.35×, and so on (any positive value). Whatever the multiplier, once active the SL trails at exactly 1× the original sl distance behind price; only the activation trigger scales. trail=0 or omitting it means no trailing. Mutually exclusive with tp.
• risk=N: optional webhook override. If omitted, the trade uses the Risk% set on the target account card. If provided (e.g. risk=0.5), it replaces the card's Risk% for this single webhook trade only.

How trail=N works

Example: buy EURUSD, sl=20, trail=2 entered at 1.1000 →

1. Initial SL is placed 20 pips below entry (1.0980). Trail is armed but inactive.
2. Price must first move +40 pips in profit (2× the 20-pip SL, reaching 1.1040); this is the activation trigger.
3. From that moment on, the SL trails 20 pips (1× SL) behind the current price; the offset never scales with the multiplier.
4. SL only ever moves in the profitable direction; it never widens.

trail=1 behaves like the classic trailing stop (activates at 1× SL distance). For sells the logic mirrors: the trail activates once price drops N × sl distance below entry, then the SL follows price downward at 1× the SL distance.

Entry examples

# Buy XAUUSD with 100 SL, 200 TP (uses account card's Risk%)
dashboardID,buy,XAUUSD,sl=100,tp=200

# Sell EURUSD with trailing stop ON (uses account card's Risk%)
dashboardID,sell,EURUSD,sl=20,trail=1

# Buy GBPUSD with a fixed TP and risk override
dashboardID,buy,GBPUSD,sl=30,tp=60,risk=1.5

2. Exit signals (close commands)

Closes existing positions opened by the EA. Exit signals ignore sl, tp, trail, and risk; they only need a dashboard ID, an action, and (in most cases) a symbol. They also bypass trading-window restrictions so emergency exits always go through.

# Close all positions on a specific symbol (both buys and sells)
dashboardID,close,SYMBOL

# Close every open position on the account, across all symbols
dashboardID,closeall

# Close only BUY positions on a specific symbol (sells stay open)
dashboardID,closebuy,SYMBOL

# Close only SELL positions on a specific symbol (buys stay open)
dashboardID,closesell,SYMBOL

Actions

• close: closes every open position matching SYMBOL (both directions).
• closeall: closes every open position on the account, regardless of symbol. No symbol needed.
• closebuy: closes only BUY positions on SYMBOL. SELLs are untouched.
• closesell: closes only SELL positions on SYMBOL. BUYs are untouched.

Exit examples

# Close all EURUSD positions only (other symbols stay open)
dashboardID,close,EURUSD

# Close EVERY open position on the account
dashboardID,closeall

# Close only BUY positions on XAUUSD
dashboardID,closebuy,XAUUSD

# Close only SELL positions on XAUUSD
dashboardID,closesell,XAUUSD

3. Modify signals (adjust SL / TP)

Updates the Stop Loss and/or Take Profit on every open position for the given symbol opened by this EA (matched by magic number), across every account on the dashboard, without having to touch each terminal. Modify follows the EA's own SL/TP Mode, exactly like entry signals (requires EA v1.5.5+). Omit a field, or pass 0, to leave that side unchanged. Modify bypasses trading-window restrictions and does not open new positions.

Pips mode (signed adjustment)

When the EA is in Pips mode, the number is a signed pip adjustment applied to the position's current SL/TP, not entry, not live price. The sign sets the direction:

• Stop Loss: a negative value moves the SL toward profit / break-even (reduces risk); a positive value moves it away (widens risk).
• Take Profit: a positive value pushes the TP further into profit; a negative value pulls it closer.
• If the position currently has no SL/TP set, the pip delta is anchored from the entry price instead.

# BUY USDJPY, SL currently 20 pips away
dashboardID,USDJPY,modify,sl=-20   # move SL to break-even (lock)
dashboardID,USDJPY,modify,sl=-10   # tighten, still some risk
dashboardID,USDJPY,modify,sl=20    # widen SL by 20 pips (more risk)
dashboardID,USDJPY,modify,tp=30    # push TP 30 pips further into profit
dashboardID,USDJPY,modify,tp=-30   # pull TP 30 pips closer

Price mode (absolute prices)

When the EA is in Price mode, sl and tp are absolute prices, just like entry signals in price mode.

# Move SL on every XAUUSD position to 2380.50 and TP to 2420.00
dashboardID,XAUUSD,modify,sl=2380.50,tp=2420.00

# Move SL on every EURUSD position to break-even at 1.0850 (TP unchanged)
dashboardID,EURUSD,modify,sl=1.0850

# Tighten TP on every GBPUSD position to 1.2750 (SL unchanged)
dashboardID,GBPUSD,modify,tp=1.2750

Fields

• SYMBOL,modify: the symbol comes before modify, consistent with the direction-specific format. The legacy modify,SYMBOL order is also accepted.
• SYMBOL: required. The exact broker symbol of the open positions to adjust.
• sl=NN: new SL. In Pips mode a signed pip delta (e.g. sl=-20); in Price mode an absolute price (e.g. sl=1.0850). Omit or set to 0 to keep the current SL.
• tp=NN: new TP, same units as sl. Omit or set to 0 to keep the current TP.
• At least one of sl or tp must be provided (non-zero).

Direction-specific modify (requires EA v1.6.5+)

For arbitrage or hedged strategies where you have both a long and short open on the same symbol, prefix with the direction to target only one side. The format mirrors entry signals: direction comes second, modify comes after the symbol.

# Modify only LONG positions on XAUUSD (shorts untouched)
dashboardID,buy,XAUUSD,modify,sl=-20

# Modify only SHORT positions on EURUSD (longs untouched)
dashboardID,sell,EURUSD,modify,sl=1.0820,tp=1.0750

# Modify ALL positions on a symbol (both directions)
dashboardID,XAUUSD,modify,sl=-20

Notes: modify only touches positions opened by this EA on this dashboard (same magic number). Accounts without an open position in SYMBOL are skipped silently with a "No matching positions to modify" log line; no error is raised. Resulting SL/TP values must respect the broker's stop level; otherwise the position is left unchanged and the error is logged in the trade queue.

Both entry and modify signals follow the EA's SL/TP input mode: Pips mode (default) or absolute Price mode. For modify in Pips mode the value is a signed adjustment to the current SL/TP; in Price mode it is an absolute price.