Position Volume Milestone

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 $100K 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.

Filter	Type	Description
`position_ids`	string[]	Restrict to specific outcome tokens by position ID (max 500).
`condition_ids`	string[]	Restrict to specific markets by condition ID (max 500).
`outcomes`	string[]	Restrict by outcome name, e.g. `["Yes", "No"]` (max 500).
`timeframes`	string[]	One or more windows: `1m`, `5m`, `30m`, `1h`, `6h`, `24h`, `7d`, `30d`, `lifetime`.
`milestone_amounts`	integer[]	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

Event Volume Milestone

Price Spike

Introduction

Trader events

Metrics

Holders

Milestones

Spikes

Market lifecycle

Asset prices

Webhooks

Webhook Callbacks

Position Volume Milestone

When to use this

Subscription filters

Example

Notes

​When to use this

​Subscription filters

​Example

​Notes

When to use this

Subscription filters

Example

Notes