tradingview-webhooklisted
Install: claude install-skill saatwik-1157/trade-research
# TradingView alert webhook receiver
TradingView's only supported push integration. A Pine `alert()` POSTs to a URL
you control; this listens, authenticates, and appends to a log.
```bash
python tools/tv_webhook.py --secret "$TV_WEBHOOK_SECRET"
python tools/tv_webhook.py --secret "..." --port 8080 --allow-tv-ips
python tools/tv_webhook.py --show # summarise the log
```
## It records. It does not trade.
This server holds no broker credentials and calls no execution endpoint. Do not
extend it into one on your own initiative — wiring an alert receiver straight
to order placement turns a research tool into an unattended trading bot, which
has entirely different failure modes and needs the user's explicit, separate
decision. If asked for that, confirm first and treat it as its own piece of
work.
## Setup, in order
1. **Start the receiver.** It binds to `127.0.0.1` by default. Keep it there.
2. **Expose it.** TradingView cannot reach localhost:
`cloudflared tunnel --url http://localhost:8000` or `ngrok http 8000`.
3. **Paste the public URL** into the alert's Webhook URL field. Webhooks
require a paid TradingView plan (Essential and above).
4. **Put the secret in the alert body.** TradingView cannot send custom
headers, so the shared secret has to travel in the payload:
```json
{"secret":"<your secret>","ticker":"{{ticker}}",
"action":"{{strategy.order.action}}","price":"{{close}}","time":"{{timenow}}"}
```
5. **Check reachability** w