Skip to main content
Event: price_spike
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event
Get notified when a position’s raw trade price changes rapidly. 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_price_change_pctnumberNoMinimum price 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": "price_spike",
  "min_price_change_pct": 15,
  "spike_direction": "up",
  "window_secs": 120
}

​
Response

{
  "event": "price_spike",
  "timestamp": 1775913505260,
  "data": {
    "position_id": "0xabc123",
    "condition_id": "0x1234567890abcdef",
    "event_slug": "us-presidential-election-2028",
    "outcome": "Yes",
    "outcome_index": 0,
    "previous_price": 0.52,
    "current_price": 0.68,
    "spike_direction": "up",
    "spike_pct": 30.77
  }
}
Last modified on April 13, 2026