Ghost webhook payload reference

Use your private ticker webhook URL from Ghost. Keep that URL private. This reference describes the payload format checker, not a promise that an order will execute. Account access, ticker settings, instrument rules, and broker responses still apply.

TradingView alerts, NinjaTrader, server-side QC Signals, and compatible JSON sources can provide alerts. Send one JSON object, up to 16 KB. Replace every template placeholder before sending.

Fields and aliases

Use one alias per group. Avoid conflicting aliases. Extra fields are not evidence that a feature is supported; use the ticker settings for execution controls.

Fields	Type	Requirement and meaning
action, side, direction, signal, order, command, type, event	string	One action alias is required. An exit word in any action alias takes precedence. Trade intent.
entry, price, close_price, exit_price, close	number or numeric string	One price alias is required for an entry; optional for exits. Reference price, not confirmation of a broker fill.
sl, stop_loss, stopLoss, stop, stoploss	positive number, numeric string, or object with stopPrice / price	Optional Absolute stop price.
tp, take_profit, takeProfit, target, profit, take	positive number, numeric string, or object with limitPrice / takeProfit / price	Optional Absolute target price.
symbol, pair, ticker	string	Optional; if supplied, must match the ticker or an accepted alias. Market identity; the private ticker webhook URL controls routing.

Actions

Entry: buy, sell, long, short, enter_long, enter_short.

Exit: exit, close, flat, flatten, close_long, close_short, close_buy, close_sell, long exit, short exit, long_exit, short_exit, exit_long, exit_short, exit long, exit short, partial_exit.

Sizing and bracket limitations

The optional quantityType or quantity_type accepts fixed_quantity or fixed. Unsupported sizing modes are rejected for entries. Dollar-based risk is not supported by this format checker. Stop and target offsets (percent, amount, pnlAmount, trailAmount, trailPercent) are rejected for entries; use absolute prices. Quantity behavior depends on your ticker settings.

Synthetic examples

Entry

Synthetic price; replace it with the source price.

{
  "action": "buy",
  "ticker": "MNQ",
  "price": 20000
}

Exit

An exit does not require a reference price.

{
  "action": "exit",
  "ticker": "MNQ"
}

Flip from long to short

Send an opposite sell entry for a long position. Reversal behavior depends on your ticker settings; a valid format does not guarantee an entry. There is no flip action in this validator.

{
  "action": "sell",
  "ticker": "MNQ",
  "price": 20000
}

These examples submit nothing. Check format in Ghost before using an alert. Software, not investment advice.

Learn about Ghost