Skip to main content
WEBHOOK
position-metrics
{
  "position_id": "<string>",
  "outcome": "<string>",
  "outcome_index": 123,
  "timeframe": "<string>",
  "volume_usd": 123,
  "buy_volume_usd": 123,
  "sell_volume_usd": 123,
  "fees": 123,
  "txns": 123,
  "buys": 123,
  "sells": 123,
  "unique_traders": 123,
  "price_open": 0.5,
  "price_close": 0.5,
  "price_high": 0.5,
  "price_low": 0.5,
  "probability_open": 0.5,
  "probability_close": 0.5,
  "probability_high": 0.5,
  "probability_low": 0.5
}

Body

application/json

Payload delivered when a position's volume or transaction metrics cross a configured threshold

position_id
string | null

ERC-1155 outcome token ID

outcome
string | null

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

outcome_index
integer<int16> | null

Outcome index

timeframe
string | null

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

volume_usd
number | null

Total trading volume in USD

buy_volume_usd
number | null

Buy volume in USD

sell_volume_usd
number | null

Sell volume in USD

fees
number | null

Total fees in USD

txns
integer<int64> | null
buys
integer<int64> | null
sells
integer<int64> | null
unique_traders
integer<int64> | null
price_open
number | null
Required range: 0 <= x <= 1
price_close
number | null
Required range: 0 <= x <= 1
price_high
number | null
Required range: 0 <= x <= 1
price_low
number | null
Required range: 0 <= x <= 1
probability_open
number | null
Required range: 0 <= x <= 1
probability_close
number | null
Required range: 0 <= x <= 1
probability_high
number | null
Required range: 0 <= x <= 1
probability_low
number | null
Required range: 0 <= x <= 1

Response

Webhook delivery acknowledged

Last modified on March 17, 2026