Webhooks

A webhook is the bridge between a TradingView alert and a HookTrader strategy. You create one in HookTrader, get a URL, paste that URL into a TradingView alert, and from then on every fire of that alert lands as an event in your strategy.

Articles:

• What TradingView sends — the request shape and what HookTrader does with it.
• Creating a webhook — the 4-step strategy wizard from the receiving side.
• Alert payload (v2) — the canonical JSON HookTrader expects after mapping.
• Capture and map — how to translate an arbitrary indicator's payload into v2.
• Stale-alert guard — what protects you from replayed or queued-up alerts.

Lifecycle

A webhook transitions through these states:

draft → learning → configuring → active ↔ paused

State	What the receiver does
draft	Created but not yet wired. No payloads accepted.
learning	Captures incoming payloads but does not place trades. Safe to fire test alerts.
configuring	Captured payloads exist; you're authoring mapping rules. Still no trades.
active	Real trades fire on entry alerts.
paused	Captures stop and trades are suppressed; existing open trades keep running.

The wizard refuses to activate a webhook while any blocker (no captures, invalid mapping, no API key) is outstanding. Use Back to learning on the strategy detail page to fire test alerts without risking a real trade.