Skip to main content
Event: event_metrics
Cost: 0.1 credits per delivery
The event_metrics callback fires when an event’s aggregated metrics cross your thresholds within a timeframe. The full payload schema is in the auto-generated Event Metrics callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Detect when total volume across all markets in an event crosses a threshold inside a rolling window.
  • Track fee accrual or transaction count at the event level rather than per market.
  • Drive “hot event” alerts while excluding noisy short-term Up/Down markets.

​
Subscription filters

Add these to the filters object when you create the subscription.
FilterTypeDescription
event_slugsstring[]Restrict to specific events by slug (max 500).
min_volume_usdnumberMinimum traded volume in USD.
max_volume_usdnumberMaximum traded volume in USD.
min_feesnumberMinimum fees accrued in USD.
min_txnsintegerMinimum transaction count.
min_unique_tradersintegerMinimum number of unique traders.
timeframesstring[]One or more windows: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d, lifetime.
exclude_shortterm_marketsbooleanExclude short-term Up/Down markets.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "event_metrics",
  "filters": {
    "min_volume_usd": 250000,
    "timeframes": ["24h"],
    "exclude_shortterm_markets": true
  }
}

​
Notes

  • timeframes selects which rolling windows are evaluated; the event fires when the thresholds are met in any listed window.
  • Set exclude_shortterm_markets to drop high-churn Up/Down markets from the aggregation.
Last modified on June 3, 2026