Skip to main content
Room ID: polymarket_event_metrics
Endpoint: wss://api.struct.to/ws
Rate: 0.025 credits per message
Stream aggregated metric updates at the event level. This room provides volume, fee, and activity data rolled up across all markets within an event.

Subscribe

The event_slugs filter is required. You may optionally specify timeframes to limit which windows you receive.

Filters

FilterTypeRequiredDescription
event_slugsstring[]YesEvents to track by slug
timeframesstring[]NoTimeframe windows to receive updates for

Example

{
  "type": "join_room",
  "payload": {
    "room_id": "polymarket_event_metrics"
  }
}
{
  "type": "room_message",
  "payload": {
    "room_id": "polymarket_event_metrics",
    "message": {
      "action": "subscribe",
      "event_slugs": ["us-presidential-election-2026"]
    }
  }
}

Response

{
  "type": "event_metrics_stream_subscribe_response",
  "room_id": "polymarket_event_metrics",
  "data": {
    "event_slugs": ["us-presidential-election-2026"],
    "timeframes": [],
    "rejected": []
  }
}

Events

event_metrics_update

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.
USD and shares volumes are decimal strings to preserve precision. Builder-attributed fields cover the subset of activity routed through builder-signed orders.
{
  "type": "event_metrics_update",
  "room_id": "polymarket_event_metrics",
  "data": {
    "event_slug": "us-presidential-election-2026",
    "timeframe": "1h",
    "timestamp": 1743500000,
    "usd_volume": "2500000.00",
    "shares_volume": "3850000.00",
    "builder_usd_volume": "620000.00",
    "builder_shares_volume": "955000.00",
    "fees": 5000.0,
    "builder_fees": 1240.0,
    "txns": 12400,
    "builder_txns": 3100,
    "unique_traders": 3200,
    "unique_builder_traders": 820
  }
}
Last modified on May 9, 2026