Position Holder Metrics

​

When to use this

• Track how many wallets hold a specific outcome token over time.
• Watch total balance and cost basis concentration on positions you care about.
• Detect accumulation or distribution as holder counts move on key positions.

​

Subscription filters

​

Example

{
  "url": "https://your-server.com/webhooks",
  "event": "position_holder_metrics",
  "filters": {
    "position_ids": [
      "71321045679252212594626385532706912750332728571942532289631379312455583992563"
    ]
  }
}

​

Notes

• The payload is a PositionHolderMetricsRow with holder count, total balance, and total cost basis, plus the owning condition and event holder counts when available.
• Each subscription accepts up to 500 position IDs.