Skip to main content
Event: event_holder_metrics
Cost: 0.025 credits per delivery
Fires with the updated holder count for the events you subscribe to. The full payload schema is in the auto-generated Event Holder Metrics callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Track the number of distinct wallets participating in an event across all its markets.
  • Watch event-level participation grow or shrink over time.
  • Compare holder breadth between events you follow.

​
Subscription filters

Add these to the filters object when you create the subscription.
FilterTypeRequiredDescription
event_slugsstring[]YesEvent slugs to track (at least one, max 500).
Unlike the optional filters on the PnL webhooks, event_slugs is required: a subscription must name at least one event to receive deliveries.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "event_holder_metrics",
  "filters": {
    "event_slugs": ["us-presidential-election-2028"]
  }
}

​
Notes

  • The payload is an EventHolderMetricsRow carrying the event slug and its holder count.
  • Each subscription accepts up to 500 event slugs.
Last modified on June 13, 2026