Webhook Alerts

Push signal notifications to any HTTP endpoint — Discord, Slack, or custom services.

Add Webhook

Webhook URL *

Discord and Slack webhooks are auto-detected and formatted natively.

Name / Label (optional)

Secret (optional — for HMAC-SHA256 signature)

If set, deliveries include X-TradeClaw-Signature header.

Configured Webhooks

Payload Format

Each signal delivery sends this JSON to your endpoint. Discord and Slack URLs are automatically formatted as native embeds/blocks.

{
  "event": "signal.new",
  "timestamp": "2024-03-27T12:00:00.000Z",
  "signal": {
    "id": "XAUUSD-H1-BUY-1711500000",
    "symbol": "XAUUSD",
    "timeframe": "H1",
    "direction": "BUY",
    "confidence": 78,
    "entry": 2180.5,
    "stopLoss": 2175,
    "takeProfit": [
      2190,
      2195
    ],
    "indicators": {
      "rsi": 32,
      "macd": "bullish",
      "ema": "golden_cross"
    }
  }
}

Security & API Reference

HMAC Signature

When a webhook has a secret, every delivery includes a signature header so you can verify the request came from TradeClaw:

X-TradeClaw-Signature: sha256=<HMAC-SHA256 of body using your secret>

Retry Policy

3 attempts with exponential backoff — 1s, 4s, 16s between retries. Each attempt is logged to the delivery log.

Internal API Endpoints

GET
/api/webhooks

List all webhooks

POST
/api/webhooks

Create a webhook

PATCH
/api/webhooks

Update webhook (toggle, rename, etc.)

DELETE
/api/webhooks

Delete a webhook

POST
/api/webhooks/test

Send test payload to a webhook

POST
/api/webhooks/dispatch

Dispatch a signal to all active webhooks