Skip to main content
Event: condition_holder_metrics
Cost: 0.025 credits per delivery
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 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. Unlike the optional filters on the PnL webhooks, condition_ids is required: a subscription must name at least one market to receive deliveries.

Example

Notes

  • The payload is a ConditionHolderMetricsRow carrying the condition ID and its holder count.
  • Each subscription accepts up to 500 condition IDs.
Last modified on July 13, 2026