Skip to main content
Event: event_metrics
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event
Get notified when an event’s aggregated metrics cross a threshold. Filter by event slugs, volume ranges, or timeframes to receive only the alerts you need.

​
Filters

FilterTypeRequiredDescription
event_slugsstring[]NoRestrict to specific events (max 500)
min_volume_usdnumberNoMinimum volume in USD
max_volume_usdnumberNoMaximum 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)
exclude_shortterm_marketsbooleanNoExclude short-term markets from results

​
Subscribe

{
  "op": "subscribe",
  "event": "event_metrics",
  "min_volume_usd": 5000,
  "timeframes": ["1h", "24h"]
}

​
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": "event_metrics",
  "timestamp": 1775913505260,
  "data": {
    "event_slug": "us-presidential-election-2028",
    "timeframe": "1h",
    "volume_usd": 82410.25,
    "shares_volume": 126800.0,
    "builder_usd_volume": 20800.0,
    "builder_shares_volume": 32000.0,
    "fees": 824.10,
    "builder_fees": 208.0,
    "txns": 215,
    "builder_txns": 54,
    "unique_traders": 98,
    "unique_builder_traders": 25
  }
}
Each payload includes builder-attributed counterparts for volume, fees, transactions, and unique traders so you can monitor builder-routed activity separately.
Last modified on May 9, 2026