> ## 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

> Fire a webhook with holder counts for specific markets as they change.

<Note>
  **Event:** `condition_holder_metrics` \
  **Cost:** 0.025 credits per delivery
</Note>

Fires with the updated holder count for the markets (conditions) you subscribe to. The full payload schema is in the auto-generated [Condition Holder Metrics callback](/api-reference/webhook-callbacks/condition-holder-metrics-callback) reference; this page documents the filters and matching behavior.

## When to use this

* Track the number of distinct wallets holding any outcome in a market.
* Watch participation grow or shrink across markets you care about.
* Compare holder breadth between markets within an event.

## Subscription filters

Add these to the `filters` object when you create the subscription.

| Filter          | Type      | Required | Description                                     |
| --------------- | --------- | -------- | ----------------------------------------------- |
| `condition_ids` | string\[] | Yes      | Condition IDs to track (at least one, max 500). |

Unlike the optional filters on the PnL webhooks, `condition_ids` is required: a subscription must name at least one market to receive deliveries.

## Example

```json theme={null}
{
  "url": "https://your-server.com/webhooks",
  "event": "condition_holder_metrics",
  "filters": {
    "condition_ids": [
      "0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90"
    ]
  }
}
```

## Notes

* The payload is a `ConditionHolderMetricsRow` carrying the condition ID and its holder count.
* Each subscription accepts up to 500 condition IDs.