Skip to main content

​
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: 
{
  "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: