Skip to main content
WEBHOOK
position-volume-milestone
{
  "position_id": "<string>",
  "timeframe": "<string>",
  "milestone_usd": 123,
  "current_volume_usd": 123,
  "buy_volume_usd": 123,
  "sell_volume_usd": 123,
  "fees": 123,
  "txns": 123,
  "buys": 123,
  "sells": 123,
  "condition_id": "<string>",
  "outcome": "<string>",
  "outcome_index": 123
}

Body

application/json

Payload delivered when a position's trading volume crosses a USD milestone

​
position_id
string
required

ERC-1155 outcome token ID

​
timeframe
string
required

Aggregation window (e.g. "1h", "24h")

​
milestone_usd
number
required

The USD milestone amount that was crossed

​
current_volume_usd
number
required

Current position volume at time of trigger (USD)

​
buy_volume_usd
number
required

Buy volume in USD for this timeframe

​
sell_volume_usd
number
required

Sell volume in USD for this timeframe

​
fees
number
required

Total fees in USD

​
txns
integer<int64>
required
​
buys
integer<int64>
required
​
sells
integer<int64>
required
​
condition_id
string | null

Parent market condition ID

​
outcome
string | null

Outcome name (e.g. "Yes", "No")

​
outcome_index
integer<int16> | null

Outcome index

Response

Webhook delivery acknowledged

Last modified on March 17, 2026