> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Condition Holder Metrics

> Get notified when holder metrics update for a market.

<Note>
  **Event:** `condition_holder_metrics` \
  **Endpoint:** `wss://api.struct.to/ws/alerts` \
  **Cost:** 0.025 credits per event
</Note>

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

| Filter          | Type       | Required | Description                      |
| --------------- | ---------- | -------- | -------------------------------- |
| `condition_ids` | `string[]` | Yes      | Condition IDs to track (max 500) |

## Subscribe

```json theme={null}
{
  "op": "subscribe",
  "event": "condition_holder_metrics",
  "condition_ids": ["0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b"]
}
```

## Response

```json theme={null}
{
  "event": "condition_holder_metrics",
  "timestamp": 1775913505260,
  "data": {
    "ts": 1713052800,
    "block": 68554321,
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "holder_count": 3050
  }
}
```