Skip to main content
Event: probability_spike
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event
Get notified when a position’s probability changes rapidly within a short timeframe. Configure the observation window and minimum change percentage to control sensitivity.

​
Filters

FilterTypeRequiredDescription
condition_idsstring[]NoRestrict to specific conditions (max 500)
event_slugsstring[]NoRestrict to specific events (max 500)
position_idsstring[]NoRestrict to specific positions (max 500)
outcomesstring[]NoFilter by outcome name, e.g. ["Yes", "No"] (max 500)
min_probability_change_pctnumberNoMinimum probability change percentage
spike_directionstringNoDirection filter: up, down, or both
window_secsnumberNoObservation window in seconds (1-600)
exclude_shortterm_marketsbooleanNoExclude short-term markets from results

​
Subscribe

{
  "op": "subscribe",
  "event": "probability_spike",
  "min_probability_change_pct": 10,
  "spike_direction": "both",
  "window_secs": 60
}

​
Response

{
  "event": "probability_spike",
  "timestamp": 1775913505260,
  "data": {
    "position_id": "0xabc123",
    "condition_id": "0x1234567890abcdef",
    "event_slug": "us-presidential-election-2028",
    "outcome": "Yes",
    "outcome_index": 0,
    "previous_probability": 0.45,
    "current_probability": 0.62,
    "spike_direction": "up",
    "spike_pct": 37.78
  }
}
Last modified on April 13, 2026