> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Event Metrics

> Fire a webhook when an event's aggregated metrics cross your thresholds within a timeframe.

<Note>
  **Event:** `event_metrics` \
  **Cost:** 0.1 credits per delivery
</Note>

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](/api-reference/webhook-callbacks/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

```json theme={null}
{
  "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.