Skip to main content
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

FilterTypeRequiredDescription
timeframesstring[]YesTimeframe windows: 1m, 5m, 15m, 30m, 1h, 4h, 6h, 1d, 24h, 7d, 30d (max 500)
position_idsstring[]NoRestrict to specific positions (max 500)
condition_idsstring[]NoRestrict to specific conditions (max 500)
outcomesstring[]NoFilter by outcome name, e.g. ["Yes", "No"] (max 500)
milestone_amountsinteger[]NoUSD milestone amounts to watch (max 500)

​
Subscribe

{
  "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 13, 2026