Signal Webhook Integration

What is a webhook?

A webhook is a URL on your server (or a service like Zapier) that receives an automatic HTTP POST request whenever a specific event occurs. On TradeMind AI, a webhook fires every time you generate a new trading signal.

Setting up your webhook

1. Go to /account → Signal Webhook
2. Enter your HTTPS webhook URL (use https:// — plain HTTP is not accepted for security)
3. Click Save
4. Click Test to send a sample payload to your URL immediately — use webhook.site to inspect it if you don't have a server yet

Payload structure

When a signal is generated, TradeMind sends a JSON POST body:

{
  "event": "signal.generated",
  "signal_id": "uuid-here",
  "ticker": "AAPL",
  "direction": "BULLISH",
  "confidence_score": 78,
  "entry_price": 182.40,
  "stop_price": 175.00,
  "target_price": 196.00,
  "issued_at": "2026-03-17T10:42:00Z"
}

Example: Send a Slack message with Zapier

1. Go to zapier.com → Create Zap
2. Trigger: Webhooks by Zapier → Catch Hook — copy the URL it gives you
3. Paste that URL into TradeMind AI's webhook field, click Save, then click Test
4. In Zapier, click "Test trigger" — it should show the sample payload fields
5. Action: Slack → Send Channel Message
6. Message: New [[direction]] signal for [[ticker]] — Entry: $[[entry_price]], Stop: $[[stop_price]], Target: $[[target_price]] (Confidence: [[confidence_score]]%) — use the field names from the Zapier trigger step

Example: Python script to receive webhooks

from flask import Flask, request
app = Flask(__name__)

@app.route("/webhook", methods=["POST"])
def webhook():
    data = request.get_json()
    ticker = data.get("ticker")
    direction = data.get("direction")
    entry = data.get("entry_price")
    print(f"New signal: {direction} {ticker} at " + str(entry))
    return "", 200

app.run(port=5000)

Run this with python app.py and expose it via ngrok for testing: ngrok http 5000.

Security tip

Always use HTTPS. If your endpoint is public, add a secret token check — include a shared secret in your webhook URL (e.g. https://yourserver.com/webhook?token=abc123) and validate it in your handler.