​
How It Works

Dialect continuously monitors token prices and analyzes percentage changes over sliding time windows. When a token’s price change exceeds the configured threshold within a time window, a webhook is triggered with detailed information about the price movement.

​
Sliding Window Analysis

Price changes are calculated using a sliding window approach:
  • Window Duration: Configurable time periods (1h, 3h, 6h, 12h, 24h, 7d)
  • Threshold: Percentage change required to trigger an event
  • Direction: Both upward and downward movements are detected

​
Supported Time Windows

WindowBeta StatusUse Case
1hFutureMomentum detection, immediate market shifts
3hAvailableShort-term trend confirmation
6hAvailableIntraday trend identification
12hAvailableHalf-day trend analysis
24hAvailableDaily price movement tracking
7dPlannedWeekly trend detection

​
Webhook Payload

When price change events are detected, you’ll receive a webhook with an array structure. Each individual event within the array has this structure: 
{
  "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
      }
    }
  ]
}

​
Field Details

  • direction: "up" for price increases, "down" for decreases
  • from: Price and timestamp at the start of the window
  • to: Price and timestamp at the end of the window
  • absolute: Raw price difference (to.value - from.value)
  • percentage: Percentage change over the window
  • threshold: Percentage change required to trigger the event

​
Use Cases

​
Mobile Wallet Integration

// Example webhook handler
app.post('/webhook/price-events', (req, res) => {
  const event = req.body;
  
  if (event.event === 'token_price_change') {
    // Send push notification to users holding this token
    sendPushNotification({
      title: `${event.token.symbol} ${event.change.direction === 'up' ? '📈' : '📉'} ${event.change.percentage_change.toFixed(1)}%`,
      body: `${event.token.symbol} moved ${event.change.percentage_change.toFixed(1)}% in the last ${event.trigger.window.duration}`,
      data: {
        tokenAddress: event.token.address,
        priceChange: event.change.percentage_change
      }
    });
  }
  
  res.status(200).send('OK');
});

​
Portfolio Tracker Alerts

  • Alert users when portfolio holdings have significant price movements
  • Provide context about the magnitude and timeframe of changes
  • Enable users to take action based on price movements

​
Trading Platform Integration

  • Notify traders about tokens meeting their criteria
  • Provide entry points for momentum-based trading strategies
  • Support risk management through downside alerts