Skip to main content
WEBHOOK
trader-event-pnl
{
  "timeframe": "1d",
  "trader": "<string>",
  "event_slug": "<string>",
  "markets_traded": 123,
  "outcomes_traded": 123,
  "total_buys": 123,
  "total_sells": 123,
  "total_redemptions": 123,
  "total_merges": 123,
  "total_volume_usd": 123,
  "buy_usd": 123,
  "sell_usd": 123,
  "redemption_usd": 123,
  "merge_usd": 123,
  "realized_pnl_usd": 123,
  "winning_markets": 123,
  "losing_markets": 123,
  "total_fees": 123,
  "first_trade_at": 123,
  "last_trade_at": 123
}

Body

application/json

Payload delivered when a trader's per-event PnL crosses a configured threshold

timeframe
enum<string>
required

PnL aggregation window

Available options:
1d,
7d,
30d,
lifetime
trader
string | null

Trader wallet address (lowercase)

event_slug
string | null

Event slug

markets_traded
integer<int64> | null

Number of distinct markets traded in this event

outcomes_traded
integer<int64> | null
total_buys
integer<int64> | null
total_sells
integer<int64> | null
total_redemptions
integer<int64> | null
total_merges
integer<int64> | null
total_volume_usd
number | null

Total volume in USD

buy_usd
number | null
sell_usd
number | null
redemption_usd
number | null
merge_usd
number | null
realized_pnl_usd
number | null

Realized PnL in USD for this event

winning_markets
integer<int64> | null
losing_markets
integer<int64> | null
total_fees
number | null
first_trade_at
integer<int64> | null

Unix seconds

last_trade_at
integer<int64> | null

Unix seconds

Response

Webhook delivery acknowledged

Last modified on March 17, 2026