Skip to main content
Event: price_spike
Cost: 0.2 credits per delivery
The price_spike event fires when a position’s raw trade price (not enriched probability) changes by at least your configured percentage within a look-back window. The full payload schema is in the auto-generated Price Spike callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Track abrupt moves in the underlying trade price rather than the enriched probability.
  • Alert on price swings only within a probability band you care about.
  • Filter out thin moves by requiring minimum transaction and volume activity.

​
Subscription filters

Add these to the filters object when you create the subscription.
FilterTypeDescription
position_idsstring[]Restrict to specific outcome tokens by position ID (max 500).
condition_idsstring[]Restrict to specific markets by condition ID (max 500).
event_slugsstring[]Restrict to specific events by slug (max 500).
outcomesstring[]Restrict by outcome name, e.g. ["Yes", "No"] (max 500).
min_price_change_pctnumberMinimum price change, as a percentage.
min_probabilitynumberMinimum outcome probability, 0.0–1.0.
max_probabilitynumberMaximum outcome probability, 0.0–1.0.
min_txnsintegerMinimum transaction count.
min_volume_usdnumberMinimum traded volume in USD.
spike_directionstringDirection to match: up, down, or both.
window_secsintegerLook-back window in seconds (1–600).
exclude_shortterm_marketsbooleanExclude short-term Up/Down markets.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "price_spike",
  "filters": {
    "min_price_change_pct": 8,
    "spike_direction": "up",
    "window_secs": 120,
    "min_txns": 5
  }
}

​
Notes

  • window_secs sets the look-back window (1–600 seconds) over which the change is measured.
  • spike_direction controls which moves match: up, down, or both. Defaults to up when omitted.
Last modified on June 3, 2026