BullionDocs

TradingView

Webhook Setup

Bullion receives alerts directly from TradingView. No authentication header required — alerts are validated, deduplicated, and routed to your agent automatically.

01Your webhook URL

Find your exact webhook URL in the dashboard under Alerts → Webhook setup. It follows this format:

endpoint
POST  https://your-backend.com/api/v1/webhooks/tradingview
This endpoint is public. No Authorization header is needed — TradingView webhooks don't support custom headers. The backend validates the payload structure and uses a hash-based idempotency key for deduplication. Make sure your backend domain is reachable from TradingView's servers on the public internet.

02Configure TradingView

  1. 1

    Create or edit an alert

    In TradingView, right-click your chart or strategy output and choose Add alert, or open an existing alert to edit it.
  2. 2

    Go to the Notifications tab

    Inside the alert dialog, click the Notifications tab (the bell icon row at the top of the dialog).
  3. 3

    Enable Webhook URL

    Check the Webhook URL toggle. A text field will appear — paste your Bullion webhook URL into it.
  4. 4

    Set the Message body

    Below the Notifications tab there is a Message field. Replace the default content with your JSON payload. Use TradingView's built-in placeholders to make it dynamic (they expand when the alert fires):
    json
    {
      "symbol":   "{{ticker}}",
      "side":     "{{strategy.order.action}}",
      "strategy": "my-breakout",
      "price":    {{close}}
    }
  5. 5

    Save the alert

    Click Create (or Save for an existing alert). The next time the condition triggers, TradingView will POST the payload to your endpoint. Check the Alerts page in the dashboard to confirm receipt.

03Useful TradingView placeholders

TradingView expands these placeholders in the Message body at alert time:

PlaceholderExpands to
{{ticker}}Symbol name (e.g. EURUSD)
{{strategy.order.action}}BUY or SELL depending on the strategy signal
{{close}}Closing price of the bar that triggered the alert
{{time}}UTC timestamp of the bar
{{volume}}Bar volume
Deduplication is built in. Identical payloads received within a 5-minute window are silently discarded. TradingView sometimes retries webhook deliveries — this prevents duplicate orders from reaching your agent.

Alert payload reference →