# Webhook

Send trading signals to Tradecraft from external systems (TradingView, custom bots, analytics tools) via HTTP webhooks.

### Setup

#### Step 1: Create Webhook Data Source

1. Navigate to **Strategy** → **Add Data Source**
2. Select **Webhook**
3. Name your webhook (e.g., "TradingView Alerts")
4. Copy your unique webhook URL and click create

<figure><img src="https://3175477167-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYCh2t4HDhRRiAIqY93vK%2Fuploads%2FBHHcaud7RTYHz5e3p0kl%2Fimage.png?alt=media&#x26;token=2a6f6ef6-42dc-48f8-a53a-0b4a580e8979" alt="" width="563"><figcaption><p>Webhook configuration panel.</p></figcaption></figure>

#### Step 2: Send Signals

Send POST requests with JSON payload to your webhook URL.

### Signal Format

#### Required Fields

```json
{
  "signal_type": "BUY",
  "token_address": "So11111111111111111111111111111111111111112"
}
```

### Response Codes

* **`200 OK`**: Signal processed successfully
* **`400 Bad Request`**: Invalid payload or missing required fields
* **`404 Not Found`**: Invalid webhook URL
* **`429 Too Many Requests`**: Rate limit exceeded

### Security

**Keep your webhook URL secret.** It contains authentication credentials and anyone with the URL can send signals.

To revoke access:

1. Go to **Data Sources** → **Your Webhook**
2. Click **Delete** to permanently remove the webhook
