Skip to main content
Event: position_volume_spike
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event
Get notified when a position’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)
position_idsstring[]NoRestrict to specific positions (max 500)
condition_idsstring[]NoRestrict to specific conditions (max 500)
outcomesstring[]NoFilter by outcome name, e.g. ["Yes", "No"] (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": "position_volume_spike",
  "spike_ratio": 2.5,
  "timeframes": ["5m", "30m"]
}

​
Response

{
  "event": "position_volume_spike",
  "timestamp": 1775913505260,
  "data": {
    "position_id": "0xabc123",
    "condition_id": "0x1234567890abcdef",
    "outcome": "Yes",
    "outcome_index": 0,
    "timeframe": "5m",
    "current_volume_usd": 8750.00,
    "snapshot_volume_usd": 3200.00,
    "delta_volume_usd": 5550.00,
    "spike_pct": 173.44,
    "txns": 28,
    "fees": 87.50
  }
}
Last modified on April 13, 2026