Tag Metrics

Event: tag_metrics
Cost: 0.1 credits per delivery

The tag_metrics callback fires when a tag’s aggregated metrics across all tagged markets cross your thresholds within a timeframe. The full payload schema is in the auto-generated Tag Metrics callback reference; this page documents the filters and matching behavior.

When to use this

Detect when total volume across every market under a tag crosses a threshold inside a rolling window.
Track category-level fee accrual or transaction count for tags like Politics or Sports.
Power “trending category” alerts driven by aggregated activity across tagged markets.

Subscription filters

Add these to the filters object when you create the subscription.

Filter	Type	Description
`tags`	string[]	Restrict to specific market tags (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`.

Example

{
  "url": "https://your-server.com/webhooks",
  "event": "tag_metrics",
  "filters": {
    "tags": ["politics", "elections"],
    "min_volume_usd": 100000,
    "timeframes": ["24h"]
  }
}

Notes

timeframes selects which rolling windows are evaluated; the event fires when the thresholds are met in any listed window.
Metrics are aggregated across all markets carrying the listed tags.

Last modified on June 3, 2026

Position Metrics

Position Holder 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