Browse the docs

How alerts are read

HookTrader trades on alerts in its own format. A strategy reaches it in one of three ways, shown in the Designer's Signal source section.

The Signal Connector#

The connector sends HookTrader's format itself, so there is nothing to map. See the quick start. It can also read your indicator's plots.

What the connector sets up#

A new strategy built from the connector starts with:

  • Sizing by risk: 1% of the account per trade.
  • The stop and targets from your chart's settings, read from its first alert.
  • Three targets: a third off with the stop to break-even, then half of what is left, then close.

Later changes to HookTrader's defaults do not rewrite it.

Alerts HookTrader writes#

Strategies started from a shape or Blank use this.

  1. In the Go live card, click Set up alerts.
  2. Each alert names the signal to attach it to and the Message to paste.
  3. Create it in TradingView with your webhook URL, and fire it once.
One alert from Set up alerts: the webhook URL, the signal to attach it to, and the message to paste.
One alert, with the message to paste.

An alert that cannot be used turns amber and names the field at fault. Usually a {{plot("Stop")}} placeholder matches no plot title on your chart.

TradingView cannot send a position size, so size these strategies by risk or a fixed amount. See Size and market.

Your indicator's own alerts#

For an indicator that already sends JSON. In Signal source, choose Change how alerts are read and paste a sample entry alert. Check the fields HookTrader tags, and drag the rest onto their roles. Separate stop, trail or target alerts each need a sample in their own tab. The binding locks once the strategy has traded.