Skip to main content
Event: market_volume_spike
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event
Get notified when a market’s 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)
condition_idsstring[]NoRestrict to specific conditions (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)

​
Subscribe

{
  "op": "subscribe",
  "event": "market_volume_spike",
  "spike_ratio": 2.0,
  "timeframes": ["5m", "1h"]
}

​
Response

{
  "event": "market_volume_spike",
  "timestamp": 1775913505260,
  "data": {
    "condition_id": "0x1234567890abcdef",
    "timeframe": "5m",
    "current_volume_usd": 24500.00,
    "snapshot_volume_usd": 11200.00,
    "delta_volume_usd": 13300.00,
    "spike_pct": 118.75,
    "txns": 63,
    "fees": 245.00
  }
}
Last modified on April 13, 2026