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

Body

application/json

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

​
condition_id
string
required

Market condition ID

​
timeframe
string
required

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

​
current_volume_usd
number
required

Current 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

Total transactions in this timeframe

​
fees
number
required

Total fees in USD for this timeframe

Response

Webhook delivery acknowledged

Last modified on March 17, 2026