> ## 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.

# Tag Metrics

> Get notified when a tag's aggregated volume or transaction metrics cross a threshold.

<Note>
  **Event:** `tag_metrics` \
  **Endpoint:** `wss://api.struct.to/ws/alerts` \
  **Cost:** 0.1 credits per event
</Note>

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) |

## Subscribe

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

## Response

<Info>
  **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.
</Info>

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


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