Skip to main content
Event: position_metrics
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event
Get notified when a position’s volume or price metrics cross a threshold. This event supports a wide range of filters for volume, fees, trader counts, and price or probability changes.

​
Filters

FilterTypeRequiredDescription
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)
min_volume_usdnumberNoMinimum volume in USD
max_volume_usdnumberNoMaximum volume in USD
min_buy_usdnumberNoMinimum buy volume in USD
min_sell_volume_usdnumberNoMinimum sell volume in USD
min_feesnumberNoMinimum fees in USD
min_txnsnumberNoMinimum transaction count
min_unique_tradersnumberNoMinimum unique trader count
min_price_change_pctnumberNoMinimum price change percentage
min_probability_change_pctnumberNoMinimum probability change percentage
timeframesstring[]NoTimeframe windows: 1m, 5m, 15m, 30m, 1h, 4h, 6h, 1d, 24h, 7d, 30d (max 500)

​
Subscribe

{
  "op": "subscribe",
  "event": "position_metrics",
  "min_volume_usd": 500,
  "outcomes": ["Yes"],
  "timeframes": ["5m", "30m"]
}

​
Response

{
  "event": "position_metrics",
  "timestamp": 1775913505260,
  "data": {
    "position_id": "0xabc123",
    "outcome": "Yes",
    "outcome_index": 0,
    "timeframe": "5m",
    "volume_usd": 3420.75,
    "buy_volume_usd": 2100.00,
    "sell_volume_usd": 1320.75,
    "fees": 34.20,
    "txns": 18,
    "buys": 12,
    "sells": 6,
    "unique_traders": 9,
    "price_open": 0.62,
    "price_close": 0.65,
    "price_high": 0.67,
    "price_low": 0.60,
    "probability_open": 0.61,
    "probability_close": 0.64,
    "probability_high": 0.66,
    "probability_low": 0.59
  }
}
Last modified on April 13, 2026