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.
FilterTypeRequiredDescription
condition_idsstring[]YesCondition 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

{
  "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.
Last modified on June 13, 2026