Skip to main content
Event: market_volume_spike
Cost: 0.2 credits per delivery
The market_volume_spike event fires when a market’s volume in a timeframe exceeds its recent baseline by your spike ratio. The full payload schema is in the auto-generated Market Volume Spike callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Detect unusual activity surges on specific markets.
  • Tune sensitivity by setting how far volume must exceed its baseline.
  • Compare activity across multiple timeframes in a single subscription.

​
Subscription filters

Add these to the filters object when you create the subscription.
FilterTypeDescription
spike_rationumberVolume must exceed its baseline by at least this ratio (must be greater than 1.0).
window_secsintegerLook-back window in seconds (1–600).
condition_idsstring[]Restrict to specific markets by condition ID (max 500).
timeframesstring[]One or more windows: 1m, 5m, 30m, 1h, 6h, 1d, 24h, 7d, 30d, lifetime.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "market_volume_spike",
  "filters": {
    "spike_ratio": 3.0,
    "window_secs": 300,
    "timeframes": ["1h"]
  }
}

​
Notes

  • spike_ratio must be greater than 1.0; for example 3.0 means 3x the recent baseline.
Last modified on June 3, 2026