Skip to main content
Event: event_volume_spike
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event
Get notified when an event’s aggregated volume exceeds its baseline by a configured ratio. The spike_ratio filter is required and defines the volume multiplier threshold.

​
Filters

FilterTypeRequiredDescription
spike_rationumberYesVolume multiplier threshold, must be greater than 1.0 (e.g. 2.0 = 2x baseline)
event_slugsstring[]NoRestrict to specific events (max 500)
timeframesstring[]NoTimeframe windows: 1m, 5m, 15m, 30m, 1h, 4h, 6h, 1d, 24h, 7d, 30d (max 500)
window_secsnumberNoWindow reset interval in seconds (1-600)
exclude_shortterm_marketsbooleanNoExclude short-term markets from results

​
Subscribe

{
  "op": "subscribe",
  "event": "event_volume_spike",
  "spike_ratio": 3.0,
  "timeframes": ["1h"]
}

​
Response

{
  "event": "event_volume_spike",
  "timestamp": 1775913505260,
  "data": {
    "event_slug": "us-presidential-election-2028",
    "timeframe": "1h",
    "current_volume_usd": 156000.00,
    "snapshot_volume_usd": 48000.00,
    "delta_volume_usd": 108000.00,
    "spike_pct": 225.00,
    "txns": 412,
    "fees": 1560.00
  }
}
Last modified on April 13, 2026