TradingView Webhooks

Webhooks let TradingView alerts trigger trades on your TraderBotz bots by sending a signed HTTP request to a unique URL when your chart conditions fire.

What Webhooks Do

They connect TradingView alert rules to bot execution: when an alert fires, TradingView POSTs JSON to TraderBotz, which validates the request and translates it into a buy or sell instruction for the linked bot according to your payload.

How to Set Up

Each bot exposes a webhook URL that includes a unique token for that bot. Copy the URL from the bot’s webhook settings and paste it into your TradingView alert as the notification destination. Only that token can authorize trades for that bot.

TradingView Alert Configuration

In the TradingView alert dialog, set the Webhook URL (sometimes shown as action URL) to your TraderBotz URL. Use the message body field to send JSON in the format TraderBotz expects—see below. Ensure the alert is allowed to fire webhooks on your TradingView plan.

JSON Payload Format

Send a JSON object with action, symbol, and optional size as a percentage of allocation—for example:

{"action": "buy", "symbol": "BTC_USD", "size_pct": 2.5}

Use "buy" or "sell" for action; symbol uses your platform’s pair naming (e.g. BTC_USD); size_pct controls order size as a percent of the bot’s allocation.

Security

Per-bot webhook tokens isolate risk: a leaked URL only affects one bot. TraderBotz expects requests over HTTPS only, protecting the token in transit. Treat the URL like a secret and rotate or disable it if you suspect exposure.