Signal Reference

The raw signal syntax that TradeSgnl accepts — every parameter, every action type, every output. Use this when you're writing Pine Script by hand or integrating from a non-TradingView source. For everyday use, the Syntax Generator is faster.

Syntax Generator Tool

Signal Format & EA Settings

The TradeSgnl EA has settings that determine which parameters it uses for trades.

TradeSgnl uses a comma-separated format with required and optional parameters:

LicenseID,SYMBOL,ACTION,risk=VOLUME,[OPTIONAL_PARAMS]

Signal Structure

Each signal consists of required components followed by optional parameters:

1. LicenseID. Your unique license identifier (e.g., LicenseID)
2. Symbol. The trading instrument (e.g., EURUSD, BTCUSD)
3. Action. The trading action (buy, sell, buystop, etc.)
4. Volume. Trading size with risk= prefix (e.g., risk=0.01)
5. Optional Parameters. Additional settings (sl=, tp=, comment=, etc.)

Format Rules

• Parameters are separated by commas with no spaces.
• All parameters are case-insensitive (buy = BUY).
• Optional parameters can be in any order.
• Values are assigned with the equals sign (sl=30).
• Risk can be in lots (risk=0.01) or percentage (risk=1) depending on EA settings.
• Partial close values can be in lots (pct=2) or percentage (pct=0.5) depending on EA settings.

Optional Parameters

Enhance your signals with these optional parameters.

Explicit Parameter Types

Explicit parameter types give you complete control directly in your signal, without relying on EA input settings. Specify exactly how volume, SL/TP, and other values should be interpreted (in pips, currency, percentages, lots, or dollar amounts).

Explicit Volume Parameters

New volume parameters with explicit type specification. Use these instead of the generic risk= parameter for precise control.

Examples:

LicenseID,EURUSD,buy,vol_lots=0.5,sl=30,tp=60

Opens a buy order with exactly 0.5 lots.

LicenseID,XAUUSD,sell,vol_dollar=100,sl_points=15,tp_points=45

Opens a sell order risking exactly $100. Requires SL for position sizing calculation.

LicenseID,EURUSD,buy,vol_pctbal_loss=1,sl_pips=50,tp_pips=100

Opens a buy order sized so that a 50 pip SL loss equals 1% of account balance.

Explicit SL/TP Parameters

Specify exactly how your Stop Loss and Take Profit values should be interpreted.

Stop Loss Types

Take Profit Types (Single Level)

Multi-Level Take Profit with Per-TP Types

Each TP level can have its own type, or inherit from the first TP level (tp1):

tp1_pips=50,tp2_percent=1,tp3_price=1.1500

TP1: 50 pips, TP2: 1% of price, TP3: exact price at 1.1500. Each with explicit type.

tp1_pips=50,tp2=100,tp3=150

TP1: 50 pips (explicit). TP2 and TP3 inherit "pips" type automatically.

Explicit Pending Parameters

Specify exactly how your pending order entry level should be interpreted, directly in your signal.

Examples:

LicenseID,EURUSD,buystop,risk=0.01,entry_pips=20,sl=30,tp=50

Buy stop 20 pips above current price, regardless of EA setting.

LicenseID,EURUSD,buylimit,risk=0.01,entry_price=1.0950,sl_pips=30,tp_pips=60

Buy limit at exactly 1.0950, regardless of EA setting.

LicenseID,BTCUSD,buystop,risk=0.01,entry_percent=2,sl_percent=1,tp_percent=3

Buy stop entry that is exactly 2% above the current price.

Explicit Trailing & Breakeven

Trailing stop and breakeven parameters support explicit type suffixes (_pips or _points) for consistent behavior across all instruments.

Trailing Stop Parameters

trtrig_points=30,trdist=20,trstep=5

Trigger uses points for currency. trdist and trstep inherit the points type automatically.

Breakeven Parameters

betrig_pips=20,bedist=2

Trigger uses explicit pips type. bedist inherits "pips" type automatically.

Examples:

LicenseID,EURUSD,buy,vol_lots=0.5,sl_pips=30,tp_pips=90,trtrig_pips=30,trdist=15,trstep=5

Forex trade with pips-based trailing: activates at 30 pips profit, trails at 15 pips distance.

LicenseID,US30,buy,vol_lots=0.5,sl_points=50,betrig_points=15,bedist=2

Index trade using points (currency) for breakeven. Distance inherits the points type.

Explicit Partial Close

New explicit partial close parameters remove ambiguity about whether you're closing a percentage or exact lots.

Examples:

LicenseID,EURUSD,closebuy,pct_percent=0.5,comment=Strategy1

Closes 50% of buy positions with comment "Strategy1".

LicenseID,XAUUSD,closesell,pct_lots=0.25

Closes exactly 0.25 lots from sell positions.

Order Types

TradeSgnl supports various order types for different trading scenarios.

Market Orders

Market order commands allow you to immediately enter or exit positions at current market prices.

buy (or long). Places a buy order at the current market price.

LicenseID,EURUSD,buy,risk=0.01

sell (or short). Places a sell order at the current market price.

LicenseID,EURUSD,sell,risk=0.01

closebuy (or closelong). Closes all buy positions for the specified symbol.

LicenseID,EURUSD,closebuy

closesell (or closeshort). Closes all sell positions for the specified symbol.

LicenseID,EURUSD,closesell

closeall. Closes all open positions for the specified symbol. Can optionally filter by comment to close only specific strategy positions.

LicenseID,EURUSD,closeall

With comment filter:

LicenseID,EURUSD,closeall,comment=Strategy1

Partial Close. Close a percentage of positions instead of the entire position. Use the pct= parameter with any close action.

LicenseID,EURUSD,closebuy,pct=0.5,comment=Strategy1

Replace Orders

Replace orders allow you to close existing positions and immediately open new positions in a single signal. This includes both same-direction updates and trend reversal strategies.

Reverse Direction Commands

closelongsell. Closes all long (buy) positions for the specified symbol (optionally filtered by comment), then opens a new sell (short) position using the provided parameters.

LicenseID,GBPUSD,closelongsell,risk=0.02,sl=40,tp=80,comment=Strategy2

closeshortbuy. Closes all short (sell) positions for the specified symbol (optionally filtered by comment), then opens a new buy position using the provided parameters.

LicenseID,EURUSD,closeshortbuy,risk=0.01,sl=30,tp=50,comment=Strategy1

Same Direction Commands

closelongbuy. Closes all long (buy) positions for the specified symbol (optionally filtered by comment), then opens a new buy position using the provided parameters.

LicenseID,EURUSD,closelongbuy,risk=0.01,sl=30,tp=50,comment=Strategy1

closeshortsell. Closes all short (sell) positions for the specified symbol (optionally filtered by comment), then opens a new sell (short) position using the provided parameters.

LicenseID,GBPUSD,closeshortsell,risk=0.02,sl=40,tp=80,comment=Strategy2

Common Trading Scenarios

• Trend Reversal Strategy: Use closelongsell or closeshortbuy when your strategy signals a trend reversal.
• Position Management: Use closelongbuy or closeshortsell to update existing positions with new parameters without manually closing first.
• Risk Management: These commands are particularly useful for automated strategies that need to quickly adapt to changing market conditions.

Pending Orders

Pending order commands allow you to set orders that will be executed when price reaches a specific level.

buystop. Places a buy stop order above the current market price. The pending= parameter is required.

LicenseID,EURUSD,buystop,risk=0.01,pending=20,sl=30,tp=50

buylimit. Places a buy limit order below the current market price. The pending= parameter is required.

LicenseID,EURUSD,buylimit,risk=0.01,pending=20,sl=30,tp=50

sellstop. Places a sell stop order below the current market price. The pending= parameter is required.

LicenseID,EURUSD,sellstop,risk=0.01,pending=20,sl=30,tp=50

selllimit. Places a sell limit order above the current market price. The pending= parameter is required.

LicenseID,EURUSD,selllimit,risk=0.01,pending=20,sl=30,tp=50

pending=. Required parameter for all pending orders. Specifies the price level for the pending order.

LicenseID,EURUSD,buystop,risk=0.01,pending=20

cancellong. Cancels all pending buy orders (buystop and buylimit) for the specified symbol.

LicenseID,EURUSD,cancellong

cancelshort. Cancels all pending sell orders (sellstop and selllimit) for the specified symbol.

LicenseID,EURUSD,cancelshort

Advanced Features

Advanced parameters that enhance your trading signals with features like trailing stops, breakeven levels, and more.

Feature Control Settings

Advanced features can be controlled by either signals or EA settings.

Trailing Stop

Add trailing stop functionality to your trades using these parameters together.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,trtrig=20,trdist=10,trstep=5

• trtrig=. Trailing stop will be activated after the trade gains this number of pips. For example, with trtrig=20, the trailing stop will activate after price moves 20 pips in your favor.
• trdist=. Distance in pips to maintain between the current price and the trailing stop. For example, with trdist=10, the stop loss will be placed 10 pips away from the current price.
• trstep=. Minimum price movement in pips required to adjust the trailing stop. For example, with trstep=5, the stop loss will only move after the price moves at least 5 pips.

Breakeven

Automatically move your stop loss to breakeven level when price reaches a certain point.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,betrig=15,bedist=2

• betrig=. Breakeven will be activated after the trade gains this number of pips. For example, with betrig=15, the breakeven will activate after price moves 15 pips in your favor.
• bedist=. Distance in pips from the entry price to place the stop loss after breakeven is triggered. With bedist=2, the stop loss will be placed 2 pips in profit from your entry.

Pyramid Trading

Configure pyramid trading strategies with multiple entries.

LicenseID,BTCUSD,buy,risk=0.01,sl=500,tp=2000,py

• py. Flag to enable pyramid trading mode. Requires the EA to have the Pyramid Mode set to "Signal" in settings. All pyramid configuration settings are controlled from the EA.

Recovery Mode

Enable recovery system for managing losing positions.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,re

• re. Flag to enable the recovery system. Requires the EA to have the Recovery Mode set to "Signal" in settings. All recovery configuration settings are controlled from the EA.

Exit Opposite Positions (ExOp)

Smart position management that closes opposite positions or opens new trades based on market conditions.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,exop

• exop. Flag that modifies trade behavior: if opposite positions exist for the symbol/comment, close them and don't execute the new trade. If no opposite positions exist, execute the trade normally.

How it works:

• Buy signal with exop: If sell positions exist, close sells and no buy is executed. If no sells exist, execute buy normally.

Exit and Enter (ExEnt)

Advanced position management that closes opposite positions and immediately opens new trades in the signal direction.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,exent

• exent. Flag that modifies trade behavior: if opposite positions exist for the symbol/comment, close them and then execute the new trade. If no opposite positions exist, execute the trade normally.

How it works:

• Buy signal with exent: If sell positions exist, close sells, then execute buy. If no sells exist, execute buy normally.

Key Differences from ExOp:

• ExOp: Closes opposite positions, then stops (no new trade opened).
• ExEnt: Closes opposite positions, then continues to open the new trade.

Ignore Exit Signals (NoExit)

Per-strategy server-side filter that drops position-close signals before they reach the EA. Other strategies on the same license are unaffected.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,noexit

• noexit. Flag added to a strategy's alert message. The server rejects resolved position-close actions (closebuy, closesell, closeall) before forwarding to the EA. Entries, reversals (closelongbuy, closeshortsell, etc.), and pending-order cancels (cancellong, cancelshort) pass through unchanged. They have different fallback semantics and are out of scope for this filter. Rejections show as rejected status (orange) in the signal history with error code 7020 for audit. Because the rejection is user-configured rather than a system failure, no email/telegram notification is sent.

Enabling NoExit: Toggle Ignore Exit Signals in the Syntax Generator next to Exit on Opposite / Exit on Entry, then recopy the alert message into TradingView.

Multi-Level Take Profit

Scale out of positions at multiple price levels with automatic partial close execution. Set unlimited TP levels (tp1, tp2, tp3, tp4, tp5, ...) with optional partial close percentages for each level.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp1=50,pct1=0.5,tp2=100,pct2=0.3,tp3=150,tp4=200

• tp1=, tp2=, tp3=, tp4=, .... Define unlimited take profit levels in pips (or points if enabled). Each level represents a price target where the EA will take action.
• pct1=, pct2=, pct3=, pct4=, .... Optional partial close percentage for each TP level (values between 0.0 and 1.0). For example, pct1=0.5 will close 50% of the position when tp1 is reached. If omitted, smart defaults are used automatically.

How it works:

• Intermediate Levels: When price reaches tp1, tp2, tp3, etc., the EA executes a partial close using the specified pct value.
• Final TP Level: The last TP level always uses MT5's native TP (closes all remaining position).
• Automatic Updates: After each partial close, the position's TP is automatically updated to the next level.
• Unlimited Support: You can set as many TP levels as your strategy requires.

Smart Defaults:

• 2 TP Levels: If pct values are omitted, first TP closes 50%, second closes remaining 50%.
• 3 TP Levels: If pct values are omitted, first TP closes 33%, second closes 50%, third closes remaining.
• 4+ TP Levels: Smart defaults divide positions equally among intermediate levels, with the final level using MT5's native TP.

Point-Based Values (For Indices & CFDs)

Use point-based values instead of pips for instruments like indices, commodities, and crypto. Perfect for US30, NAS100, DAX40, Gold, etc.

EA Setting Required: In EA General Settings, enable "Use Points Instead of Pips" to activate this feature.

With Feature Enabled:

LicenseID,US30,buy,risk=0.25,sl=100,tp=200,comment=US30_Strategy

This signal will set SL at exactly 100 points (100.0 price distance) and TP at 200 points (200.0 price distance). No calculations needed.

How it works:

• Traditional Mode (disabled): Values interpreted as "pips" with broker-specific multipliers.
• Point Mode (enabled): Signal value directly represents price distance. Works for any broker decimal format.
• Example: sl=100 with point mode equals exactly 100 points stop loss, regardless of broker.

Signal Examples

Examples of different signal formats for various trading scenarios.

Basic Orders

Market Buy Order. Simple buy order for EURUSD with 0.01 lots.

LicenseID,EURUSD,buy,risk=0.01

Market Sell Order. Simple sell order for GBPUSD with 0.01 lots.

LicenseID,GBPUSD,sell,risk=0.01

Buy with Stop-Loss and Take-Profit. Buy order with 30 pips stop-loss and 50 pips take-profit.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50

Buy Order with Comment. Buy order with stop-loss, take-profit, and strategy comment.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,comment=Strategy1

Closing Positions

Close Specific Position Type. Close all buy positions for EURUSD.

LicenseID,EURUSD,closebuy

Close All Positions. Close all open positions for EURUSD.

LicenseID,EURUSD,closeall

Close All Positions with Comment. Close all EURUSD positions that have the comment "Strategy1".

LicenseID,EURUSD,closeall,comment=Strategy1

Partial Close 50% of Positions. Close 50% of buy positions with comment "Strategy1" (Percentage mode) or close exactly 0.5 lots (Lots mode).

LicenseID,EURUSD,closebuy,pct=0.5,comment=Strategy1

Partial Close 25% of All Positions. Close 25% of all open positions for EURUSD (Percentage mode) or close exactly 0.25 lots per EURUSD position (Lots mode).

LicenseID,EURUSD,closeall,pct=0.25

Replace Orders

Close Long Then Open Buy. Closes all long positions, then opens a new buy with provided parameters.

LicenseID,EURUSD,closelongbuy,risk=0.01,sl=30,tp=50,comment=Strategy1

Close Short Then Open Sell. Closes all short positions, then opens a new sell with provided parameters.

LicenseID,GBPUSD,closeshortsell,risk=0.02,sl=40,tp=80,comment=Strategy2

Close Long Then Open Sell. Closes all long positions, then opens a new sell with provided parameters.

LicenseID,EURUSD,closelongsell,risk=0.01,sl=25,tp=45,comment=Strategy3

Close Short Then Open Buy. Closes all short positions, then opens a new buy with provided parameters.

LicenseID,GBPUSD,closeshortbuy,risk=0.02,sl=35,tp=70,comment=Strategy4

Pending Orders

Buy Stop Pending Order. Buy stop order 20 pips above current price.

LicenseID,EURUSD,buystop,risk=0.01,pending=20,sl=30,tp=50

Buy Limit Pending Order. Buy limit order 20 pips below current price.

LicenseID,EURUSD,buylimit,risk=0.01,pending=20,sl=30,tp=50

Sell Stop Pending Order. Sell stop order 25 pips below current price.

LicenseID,GBPUSD,sellstop,risk=0.02,pending=25,sl=40,tp=80

Sell Limit Pending Order. Sell limit order 25 pips above current price.

LicenseID,GBPUSD,selllimit,risk=0.02,pending=25,sl=40,tp=80

Cancel Pending Buy Orders. Cancel all pending buy orders (buystop and buylimit) for EURUSD.

LicenseID,EURUSD,cancellong

Cancel Pending Sell Orders. Cancel all pending sell orders (sellstop and selllimit) for EURUSD.

LicenseID,EURUSD,cancelshort

Advanced Examples

Multi-Level Take Profit. Buy order with 3 TP levels: close 50% at 50 pips, 30% at 100 pips, remaining at 150 pips.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp1=50,pct1=0.5,tp2=100,pct2=0.3,tp3=150

Multi-TP with Smart Defaults. Buy order with 2 TP levels using smart defaults (50% at first TP, 50% at second).

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp1=50,tp2=100

Mixed TP Types. TP1: 10 currency, TP2: 1% of price, TP3: inherits currency type from tp1.

LicenseID,XAUUSD,buy,vol_lots=0.1,tp1_points=10,tp2_percent=1,tp3=20

Dollar Risk with Currency. Risks $100, SL at 15.00 price distance, TP at 45.00 price distance.

LicenseID,XAUUSD,sell,vol_dollar=100,sl_points=15,tp_points=45

Percentage-Based Risk. Risks 1% of balance at 50 pip SL with explicit pips type.

LicenseID,EURUSD,buy,vol_pctbal_loss=1,sl_pips=50,tp_pips=100

With Trailing Stop. Buy order with trailing stop that activates after 30 pips in profit.

LicenseID,USDJPY,buy,risk=0.05,sl=20,tp=60,trtrig=30,trdist=15,trstep=3

Trailing Stop with Currency. Index trade with explicit currency-based trailing stop activation and distance.

LicenseID,US30,buy,vol_lots=0.5,sl_points=50,tp_points=150,trtrig_points=30,trdist_points=20

Breakeven Example. Buy order with breakeven that activates after 20 pips in profit.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=60,betrig=20,bedist=2

Pyramid Trading Strategy. Buy order with pyramid trading enabled, allowing up to 3 entries.

LicenseID,BTCUSD,buy,risk=0.01,sl=500,tp=2000,py

Recovery Mode. Buy order with recovery mode enabled.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,re

Exit Opposite Positions. If sell positions exist, close them only. If no sell positions, execute the buy order normally.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,exop

Exit and Enter. Close any sell positions and then execute the buy order (reversal strategy).

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,exent

Ignore Exit Signals. Strategy entries fire normally; position-close actions from this strategy are dropped server-side before reaching the EA.

LicenseID,EURUSD,buy,risk=0.01,sl=30,tp=50,noexit

Parameter Processing Rules

When processing signals, the TradeSgnl EA follows these rules.

Symbol Names

Symbol names in signals must match exactly with the symbol names in your MT5 terminal. For example, if your broker uses "EURUSD.a" in Market Watch, your signal must use the same format.

LicenseID,EURUSD.a,buy,risk=0.01

Risk-Based Sizing

When using percentage-based risk (e.g., risk=1), the lot size is calculated as a percentage of your account balance or equity, depending on the EA's settings. The sl= parameter is not required for this calculation.

Valid Action Types

The EA supports the following action types in signals.

Signal Format Cheat Sheet

A comprehensive quick reference for all signal formats. Use this as your go-to cheat sheet for creating trading signals.