Skip to main content
Event: tag_metrics
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event
Get notified when a tag’s aggregated metrics (volume, fees, transactions, unique traders) cross a configured threshold. Alerts include a builder-attributed breakdown so you can monitor builder-routed activity separately.

​
Filters

FilterTypeRequiredDescription
tagsstring[]NoRestrict to specific tags by label or slug (max 500)
min_volume_usdnumberNoMinimum aggregated tag volume in USD
max_volume_usdnumberNoMaximum aggregated tag volume in USD
min_feesnumberNoMinimum fees in USD
min_txnsnumberNoMinimum transaction count
min_unique_tradersnumberNoMinimum unique trader count
timeframesstring[]NoTimeframe windows: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d (max 500)

​
Subscribe

{
  "op": "subscribe",
  "event": "tag_metrics",
  "tags": ["Politics"],
  "min_volume_usd": 10000,
  "min_txns": 10,
  "timeframes": ["1h"]
}

​
Response

Volume on Polymarket vs. Struct. Polymarket’s UI reports “volume” as notional (the count of shares or contracts traded), which corresponds to shares_volume in Struct payloads. usd_volume is the dollar value of those trades. Use shares_volume to match figures shown on Polymarket and usd_volume for true USD throughput.
{
  "event": "tag_metrics",
  "timestamp": 1743500000000,
  "data": {
    "tag": "politics",
    "timeframe": "1h",
    "volume_usd": 120000.0,
    "shares_volume": 148000.0,
    "builder_usd_volume": 30000.0,
    "builder_shares_volume": 37000.0,
    "fees": 600.0,
    "builder_fees": 150.0,
    "txns": 740,
    "builder_txns": 185,
    "unique_traders": 210,
    "unique_builder_traders": 54
  }
}
Last modified on May 9, 2026