> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dialect.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Technical Overview

> Integrate price alerts and automated trading triggers using webhook events. Build powerful applications by subscribing to real-time market events. Configure price thresholds and receive structured webhook payloads to trigger your application logic.

## Architecture

### Event Detection Pipeline

1. **Data Ingestion**: Real-time price feeds and on-chain data monitoring
2. **Event Processing**: Sliding window analysis and threshold detection
3. **Webhook Delivery**: Reliable delivery to your infrastructure

### Webhook Delivery

When an event is detected, Dialect sends an HTTP POST request to your configured webhook endpoint with a structured JSON payload.

## Webhook Payload Schema

All webhooks deliver events as arrays, allowing for batch delivery of multiple events in a single request. You can receive multiple events of the same type or mixed event types in one webhook call:

```json theme={null}
{
  "events": [
    {
      "event": "token_price_change",
      "timestamp": "2025-07-04T14:30:00Z",
      "token": {
        "symbol": "SOL",
        "address": "So11111111111111111111111111111111111111112"
      },
      "trigger": {
        "type": "sliding_window_percentage_change",
        "window": {
          "duration": "24h"
        },
        "threshold": 10.0
      },
      "change": {
        "direction": "up",
        "from": {
          "timestamp": "2025-07-03T14:30:00Z",
          "value": 154.25
        },
        "to": {
          "timestamp": "2025-07-04T14:30:00Z",
          "value": 171.85
        },
        "absolute": 17.6,
        "percentage": 11.42
      }
    },
    {
      "event": "trending_token",
      "timestamp": "2025-08-05T12:45:30Z",
      "token": {
        "symbol": "BOSS",
        "address": "GUy9Tu8YtvvHoL3DcXLJxXvEN8PqEus6mWQUEchcbonk"
      },
      "trigger": {
        "type": "launchpad_graduated"
      },
      "metrics": {
        "graduatedAt": "2025-08-05T12:31:03Z",
        "marketCap": 9866748.92,
        "liquidity": 850000,
        "holders": 20324,
        "price": 0.0106,
        "launchpad": "raydium",
        "mintAuthorityDisabled": true,
        "freezeAuthorityDisabled": true,
        "topHoldersPercentage": 15.2,
        "socialCount": 1,
        "priceChange1h": -2.1,
        "priceChange6h": 8.5,
        "priceChange24h": 12.3
      }
    }
    // ... more events
  ]
}
```

### Common Fields

All events share these common fields:

* **event**: Event type identifier (`token_price_change`, `trending_token`, or `token_last_trade_price_change`)
* **timestamp**: UTC timestamp when the event was generated (ISO 8601)
* **token**: Token information including symbol and mint address
* **trigger**: Configuration that caused the event to fire

The rest of the data structure is event-specific. For detailed field descriptions and specifications, see the individual event type pages for:

* [Price Change](/alerts/events/price-change),
* [Trending Token](/alerts/events/trending-token), and
* [Last Trade Price Change](/alerts/events/price-change#trade-based-price-changes-last-trade)