Tag Metrics

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

Filter	Type	Required	Description
`tags`	string[]	No	Restrict to specific tags by label or slug (max 500)
`min_volume_usd`	number	No	Minimum aggregated tag volume in USD
`max_volume_usd`	number	No	Maximum aggregated tag volume in USD
`min_fees`	number	No	Minimum fees in USD
`min_txns`	number	No	Minimum transaction count
`min_unique_traders`	number	No	Minimum unique trader count
`timeframes`	string[]	No	Timeframe windows: `1m`, `5m`, `30m`, `1h`, `6h`, `24h`, `7d`, `30d` (max 500)

{
  "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

Position Metrics

Position Holder Metrics

Introduction

Rooms

Alerts

Filters

Response

​Filters

​Subscribe

​Response

Filters

Subscribe

Response