Skip to main content
Event: condition_metrics
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event
Get notified when a market’s volume or transaction metrics cross a threshold. Use filters to narrow alerts to specific conditions, volume ranges, or timeframes.

​
Filters

FilterTypeRequiredDescription
condition_idsstring[]NoRestrict to specific conditions (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)

​
Subscribe

{
  "op": "subscribe",
  "event": "condition_metrics",
  "min_volume_usd": 1000,
  "timeframes": ["5m", "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": "condition_metrics",
  "timestamp": 1775913505260,
  "data": {
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "timeframe": "5m",
    "volume_usd": 15230.50,
    "shares_volume": 23430.0,
    "builder_usd_volume": 3850.0,
    "builder_shares_volume": 5920.0,
    "fees": 152.30,
    "builder_fees": 38.5,
    "txns": 47,
    "builder_txns": 12,
    "unique_traders": 23,
    "unique_builder_traders": 6
  }
}
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