Signal format

Signalync accepts two payload formats: a compact key=value comma-separated string and a standard JSON object. Both are sent to the same inbound endpoint, POST /api/inbound/{sourceAuthKey} , and produce the same normalized signal internally.

The comma-separated format is ideal for TradingView alert messages and Telegram bots because it is short and easy to type. The JSON format is preferred when calling the REST API directly or building custom integrations, since it is explicit and typed. Every parameter available in one format is available in the other. The minimum required fields in either format are symbol and action; everything else is optional.

Basic buy with stop loss and take profit

EURUSD,buy,vol=0.1,sl_pips=50,tp_pips=100

Sell with risk-based sizing and multi-level TP

XAUUSD,sell,vol_pctbal_loss=1,sl_pips=40,tp1_pips=40,tp2_pips=80,tp3_pips=120

Pending buy limit order

EURUSD,buylimit,entry_price=1.0750,vol=0.2,sl_pips=30,tp_pips=90

Trailing stop with breakeven

GBPUSD,sell,vol_dollar=100,sl_pips=40,tp_pips=120,trail_trigger=30,trail_distance=15,be_trigger=20

Same signal as JSON (REST API)

{
  "symbol": "EURUSD",
  "action": "buy",
  "volume": 0.1,
  "volumeType": "lots",
  "sl": 50,
  "slType": "pips",
  "tp": 100,
  "tpType": "pips",
  "comment": "MyStrategy"
}

Every field accepted by the signal parser. Use the comma-separated name in text-format signals and the JSON key when sending JSON.

Seven volume parameters give you full control over position sizing. Only one should be specified per signal.

Fixed lots

vol=0.1 or vol_lots=0.1, trade exactly 0.1 lots regardless of account balance.

EURUSD,buy,vol=0.1,sl_pips=50,tp_pips=100

Percent of balance

vol_pctbal=2, the EA calculates lots such that 2% of account balance is used as nominal position value. No stop loss required.

EURUSD,buy,vol_pctbal=2,tp_pips=80

Risk-based sizing

vol_dollar=100, vol_pctbal_loss=2, and vol_pcteq_loss=1 all compute lot size from the maximum acceptable loss on the trade. All three require a stop loss (sl_pips, sl_price, or sl_percent) so the EA can calculate the distance to the stop.

EURUSD,buy,vol_pctbal_loss=1,sl_pips=30,tp_pips=90

Stop loss and take profit can each be specified in three ways, pips, absolute price, or percentage from entry. All six variants (three SL, three TP) can be freely combined.

Multi-level take profit

Use tp1, tp2, tp3 (unlimited levels) to close portions of the position at different targets. The type suffix (_pips, _price) is inherited from tp1 if omitted on subsequent levels.

# All three levels interpreted as pips (type inherited from tp1)
EURUSD,buy,vol_pctbal_loss=2,sl_pips=30,tp1_pips=50,tp2=100,tp3=150,pct1=50,pct2=30,pct3=20

Use a pending order action when you want the broker to place an order at a future price, not the current market price. The four pending actions are buylimit, selllimit, buystop, and sellstop. All four require an entry price.

Entry parameter

Specify where the pending order should be placed using one of the entry parameters:

# Entry at an absolute price
EURUSD,buylimit,entry_price=1.0750,vol=0.2,sl_pips=30,tp_pips=90

# Entry X pips from the current price
GBPUSD,sellstop,entry_pips=40,vol=0.1,sl_pips=25,tp_pips=75

ExOp and ExEnt flags

Two flags modify how existing positions are handled when a new order signal arrives:

• exop, Exit Opposite. Close any positions in the opposite direction before placing the new order. Does not open the new position if opposite positions existed.
• exent, Exit and Enter. Close opposite positions then open the new position.

# Close any open longs, then open a buy
EURUSD,buy,vol=0.1,sl_pips=50,tp_pips=100,exent,comment=TrendFollow

Add a trailing stop or breakeven move to any market order by including the relevant parameters. The MT5 EA handles the ongoing management after the order is placed.

Trailing stop

The trailing stop activates once the trade reaches trail_trigger pips in profit, then trails the stop loss trail_distance pips behind the current price. The optional trail_step prevents the stop from moving on every tick, it only shifts when price moves at least trail_step pips.

GBPUSD,sell,vol=0.1,sl_pips=40,tp_pips=120,trail_trigger=30,trail_distance=15,trail_step=5

Breakeven

The breakeven move shifts the stop loss to the entry price (optionally locking in be_offset pips) once the trade reaches be_trigger pips in profit.

EURUSD,buy,vol_pctbal_loss=1,sl_pips=30,tp_pips=90,be_trigger=20,be_offset=2

To close part of an open position, use a close action (closebuy, closesell, or closeall) with a pct or pct_lots parameter.

# Close 50% of all open buy positions on XAUUSD
XAUUSD,closebuy,pct=50

# Close exactly 0.5 lots of sell positions, filtered by comment
EURUSD,closesell,pct_lots=0.5,comment=ScalpStrategy

Without a pct or pct_lots parameter, the close action closes the entire position.

Every inbound request is authenticated by the Source auth key embedded in the URL. An optional HMAC secret adds a second layer of verification via a request header.

• URL key, POST /api/inbound/{sourceAuthKey}. The auth key is generated when you create a Source and is the primary credential. Keep it private.
• HMAC secret (optional), If the Source has a secret configured, every request must include an X-Signalync-Secret header. Requests without a matching header are rejected with 401 HMAC_MISMATCH.