Skip to main content
Room ID: polymarket_market_metrics
Endpoint: wss://api.struct.to/ws
Rate: 0.025 credits per message
Stream real-time volume, fees, and transaction metrics for specific markets. Updates are pushed whenever metric values change within the tracked timeframe windows.

Subscribe

The condition_ids filter is required. You may optionally specify timeframes to limit which windows you receive. A maximum of 100 filters is allowed per client.

Filters

FilterTypeRequiredDescription
condition_idsstring[]YesMarkets to track by condition ID
timeframesstring[]NoTimeframe windows to receive updates for

Example

{
  "type": "join_room",
  "payload": {
    "room_id": "polymarket_market_metrics"
  }
}
{
  "type": "room_message",
  "payload": {
    "room_id": "polymarket_market_metrics",
    "message": {
      "action": "subscribe",
      "condition_ids": ["0xabc123..."]
    }
  }
}

Response

{
  "type": "market_metrics_stream_subscribe_response",
  "room_id": "polymarket_market_metrics",
  "data": {
    "condition_ids": ["0xabc123..."],
    "timeframes": [],
    "rejected": []
  }
}

Events

market_metrics_update

{
  "type": "market_metrics_update",
  "room_id": "polymarket_market_metrics",
  "data": {
    "condition_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "timeframe": "1h",
    "timestamp": 1743500000,
    "usd_volume": "125000.50",
    "fees": 250.0,
    "txns": 340,
    "unique_traders": 85
  }
}
Last modified on April 13, 2026