Event Metrics

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.

Filter	Type	Description
`event_slugs`	string[]	Restrict to specific events by slug (max 500).
`min_volume_usd`	number	Minimum traded volume in USD.
`max_volume_usd`	number	Maximum traded volume in USD.
`min_fees`	number	Minimum fees accrued in USD.
`min_txns`	integer	Minimum transaction count.
`min_unique_traders`	integer	Minimum number of unique traders.
`timeframes`	string[]	One or more windows: `1m`, `5m`, `30m`, `1h`, `6h`, `24h`, `7d`, `30d`, `lifetime`.
`exclude_shortterm_markets`	boolean	Exclude 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

Condition Metrics

Position Metrics

Introduction

Trader events

Metrics

Holders

Milestones

Spikes

Market lifecycle

Asset prices

Webhooks

Webhook Callbacks

When to use this

Subscription filters

Example

Notes

​When to use this

​Subscription filters

​Example

​Notes

When to use this

Subscription filters

Example

Notes