Skip to main content
Event: position_volume_milestone
Cost: 0.2 credits per delivery
Fires when a position’s cumulative volume crosses one of your USD milestones. The full payload schema is in the auto-generated Position Volume Milestone callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Track when a specific outcome token reaches a notable volume threshold.
  • Watch a single side of a market (e.g. Yes) cross 100Kor100K or 1M in volume.
  • Trigger alerts or workflows when a position hits a liquidity milestone within a chosen window.

​
Subscription filters

Add these to the filters object when you create the subscription. timeframes is required.
FilterTypeDescription
position_idsstring[]Restrict to specific outcome tokens by position ID (max 500).
condition_idsstring[]Restrict to specific markets by condition ID (max 500).
outcomesstring[]Restrict by outcome name, e.g. ["Yes", "No"] (max 500).
timeframesstring[]One or more windows: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d, lifetime.
milestone_amountsinteger[]USD milestone thresholds to fire on (max 500).

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "position_volume_milestone",
  "filters": {
    "outcomes": ["Yes"],
    "timeframes": ["24h"],
    "milestone_amounts": [100000, 1000000]
  }
}

​
Notes

  • milestone_amounts are USD thresholds. Each amount fires once when the position’s cumulative volume crosses it.
Last modified on June 3, 2026