Skip to main content
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.
FilterTypeDescription
tagsstring[]Restrict to specific market tags (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.

​
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