Skip to main content
WEBHOOK
position-volume-spike
{
  "position_id": "<string>",
  "condition_id": "<string>",
  "timeframe": "<string>",
  "current_volume_usd": 123,
  "snapshot_volume_usd": 123,
  "delta_volume_usd": 123,
  "spike_pct": 123,
  "txns": 123,
  "fees": 123,
  "outcome": "<string>",
  "outcome_index": 123
}

Body

application/json

Payload delivered when a position's volume has spiked since the last snapshot

position_id
string
required

ERC-1155 outcome token ID

condition_id
string
required

Parent market condition ID

timeframe
string
required

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

current_volume_usd
number
required

Current position volume at the time of the spike (USD)

snapshot_volume_usd
number
required

Volume at the snapshot baseline (USD)

delta_volume_usd
number
required

New volume since the snapshot that triggered this notification (USD)

spike_pct
number
required

Volume growth as a percentage of the snapshot (e.g. 200.0 means volume tripled)

txns
integer<int64>
required
fees
number
required
outcome
string | null

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

outcome_index
integer<int16> | null

Response

Webhook delivery acknowledged

Last modified on March 17, 2026