Alert Message Format

JSON Payload Structure

Every TradingView alert message sent to HyperSync must be valid JSON:

{
  "symbol": "{{ticker}}",
  "action": "buy",
  "price": {{close}},
  "strategy": "My Strategy Name",
  "confidence": 0.8,
  "secret": "YOUR_WEBHOOK_TOKEN"
}

Field Reference

Field	Type	Required	Description
symbol	string	Yes	Trading pair (e.g., "BTC", "ETH", "SOL")
action	string	Yes	Trade action: "buy", "sell", or "close"
price	number	Yes	Current price at signal time
strategy	string	No	Strategy name/identifier for filtering
confidence	number	No	Signal confidence (0.0 - 1.0). Default: 1.0
secret	string	Yes	Your unique webhook token
amountPct	number	No	Partial close percentage (0.0 - 1.0). Only used with "close"
signalId	string	No	Custom signal ID for idempotency

Actions Explained

buy — Open Long Position

Opens a long (buy) position on the specified symbol.

{
  "symbol": "BTC",
  "action": "buy",
  "price": {{close}},
  "confidence": 0.85,
  "secret": "your-token"
}

sell — Open Short Position

Opens a short (sell) position on the specified symbol.

{
  "symbol": "ETH",
  "action": "sell",
  "price": {{close}},
  "confidence": 0.9,
  "secret": "your-token"
}

close — Close Position

Closes the entire existing position for the symbol.

{
  "symbol": "BTC",
  "action": "close",
  "price": {{close}},
  "secret": "your-token"
}

Partial Close

Close a portion of your position using amountPct:

{
  "symbol": "BTC",
  "action": "close",
  "price": {{close}},
  "amountPct": 0.5,
  "secret": "your-token"
}

This closes 50% of your BTC position.

TradingView Variables

Use TradingView's built-in variables in your alert message:

Variable	Description	Example Output
{{ticker}}	Symbol name	BTCUSDT
{{close}}	Current close price	60234.50
{{open}}	Current open price	59800.00
{{high}}	Current high price	60500.00
{{low}}	Current low price	59600.00
{{volume}}	Current volume	1234567
{{time}}	Alert timestamp	2026-01-15T10:30:00Z
{{timenow}}	Current timestamp	2026-01-15T10:30:05Z
{{exchange}}	Exchange name	BINANCE
{{interval}}	Chart timeframe	60 (minutes)

Complete Alert Examples

RSI Oversold Buy Signal

{
  "symbol": "{{ticker}}",
  "action": "buy",
  "price": {{close}},
  "strategy": "RSI Oversold",
  "confidence": 0.8,
  "secret": "abc123def456"
}

MACD Crossover Sell Signal

{
  "symbol": "{{ticker}}",
  "action": "sell",
  "price": {{close}},
  "strategy": "MACD Bearish Cross",
  "confidence": 0.75,
  "secret": "abc123def456"
}

Take Profit Close

{
  "symbol": "{{ticker}}",
  "action": "close",
  "price": {{close}},
  "strategy": "Take Profit 5%",
  "confidence": 1.0,
  "secret": "abc123def456"
}

Partial Take Profit (Close 50%)

{
  "symbol": "{{ticker}}",
  "action": "close",
  "price": {{close}},
  "amountPct": 0.5,
  "strategy": "Partial TP",
  "secret": "abc123def456"
}

Idempotency

Include a signalId to prevent duplicate signal processing:

{
  "symbol": "BTC",
  "action": "buy",
  "price": 60000,
  "signalId": "rsi_buy_2026_01_15_btc",
  "secret": "your-token"
}

If a signal with the same signalId has already been processed, it won't be executed again.