Skip to content

HookTrader Signal Connector#

The Signal Connector is a free Pine indicator we publish on TradingView. It wraps any long/short signal source and emits HookTrader's v2 envelope directly via Pine's alert() calls — so there's nothing to copy-paste into the TradingView alert dialog.

Why use it#

  • No mapping work. Captures from the connector arrive already in v2 shape. The preset ships a mapping that's effectively a passthrough.
  • No copy-paste in TradingView. The Pine script calls alert() with the correct JSON for entry / TP / trail / SL events. You create one TradingView alert with condition "Any alert() function call" and the message box stays empty.
  • One indicator, all event types. Entry, tp1…tpN, trail updates, SL hits, and custom events all fire from the same Pine script. You don't author six different alert templates.

Setup#

  1. In the strategy wizard, pick HookTrader Signal Connector at step 0.
  2. Continue through the wizard. The mapping is pre-loaded; you mainly need to confirm sizing + TP actions in step 2.
  3. On the strategy detail page, copy the webhook URL.
  4. In TradingView, add HookTrader Signal Connector to your chart.
  5. Wire your signal source into the connector via its input dropdowns (long signal, short signal, SL source, TP sources). The connector handles everything else.
  6. Create a TradingView alert on the chart:
    • Condition: the connector.
    • Trigger: Any alert() function call.
    • Webhook URL: (your HookTrader URL).
    • Message: leave empty.
  7. Save the alert. From the next signal onwards, HookTrader receives canonical v2 events.

What the connector emits#

Pine event Sent to HookTrader as
Long entry signal entry with side: "long" and your SL / TPs
Short entry signal entry with side: "short"
TP cross detected tp_hit with level: N
Trail update trail with new sl
SL hit exit with reason: "sl_hit"
Manual close button exit with reason: "manual"

If you're testing without a real signal source, the connector has a Test mode that fires a synthetic entry on bar close — useful for end-to-end smoke tests.

Limitations#

  • Sizing currently comes via qty in the entry payload (i.e. effectively qty_mode = from_indicator). For risk_pct sizing, omit qty from the connector and configure risk_pct on the webhook. The connector still emits the SL so HookTrader can compute the correct quantity automatically.
  • TP source on the connector defaults to webhook — the connector emits tp_hit events. If you'd rather have HookTrader gate on platform price (e.g. for paper trading), switch the webhook's tp_source to platform or auto.

See also#