Position Volume Milestone

Event: position_volume_milestone
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event

Get notified when a position’s trading volume crosses a USD milestone. You must specify at least one timeframe to subscribe.

Filters

Filter	Type	Required	Description
`timeframes`	string[]	Yes	Timeframe windows: `1m`, `5m`, `30m`, `1h`, `6h`, `24h`, `7d`, `30d` (max 500)
`position_ids`	string[]	No	Restrict to specific positions (max 500)
`condition_ids`	string[]	No	Restrict to specific conditions (max 500)
`outcomes`	string[]	No	Filter by outcome name, e.g. `["Yes", "No"]` (max 500)
`milestone_amounts`	integer[]	No	USD milestone amounts to watch (max 500)

{
  "op": "subscribe",
  "event": "position_volume_milestone",
  "timeframes": ["1h"],
  "condition_ids": ["0x1234567890abcdef"],
  "milestone_amounts": [5000, 10000]
}

Response

{
  "event": "position_volume_milestone",
  "timestamp": 1775913505260,
  "data": {
    "position_id": "0xabc123",
    "condition_id": "0x1234567890abcdef",
    "outcome": "Yes",
    "outcome_index": 0,
    "timeframe": "1h",
    "milestone_usd": 10000,
    "current_volume_usd": 10540.30,
    "buy_volume_usd": 7200.50,
    "sell_volume_usd": 3339.80,
    "fees": 105.40,
    "txns": 42,
    "buys": 28,
    "sells": 14
  }
}

Last modified on April 30, 2026

Event Volume Milestone

Price Spike

Introduction

Rooms

Alerts

Position Volume Milestone

Filters

Response

​Filters

​Subscribe

​Response

Filters

Subscribe

Response