Skip to main content
Event: condition_holder_metrics
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.025 credits per event
Fires when the holder count updates for one of the markets (conditions) you subscribe to. The condition_ids filter is required: you only receive metrics for the condition IDs you name.

Filters

FilterTypeRequiredDescription
condition_idsstring[]YesCondition IDs to track (max 500)

Subscribe

{
  "op": "subscribe",
  "event": "condition_holder_metrics",
  "condition_ids": ["0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b"]
}

Response

{
  "event": "condition_holder_metrics",
  "timestamp": 1775913505260,
  "data": {
    "ts": 1713052800,
    "block": 68554321,
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "holder_count": 3050
  }
}
Last modified on June 13, 2026