Skip to main content
Event: trader_event_pnl
Cost: 0.1 credits per delivery
Fires when a trader’s aggregated realized PnL for an event crosses your configured bounds. The full payload schema is in the auto-generated Trader Event PnL callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Alert when a trader’s combined PnL across all markets in an event clears a profit or loss threshold.
  • Track performance on specific events by slug rather than individual markets or a trader’s whole book.
  • Qualify event-level conviction by pairing PnL bounds with volume and the number of distinct markets traded.

​
Subscription filters

Add these to the filters object when you create the subscription.
FilterTypeDescription
tradersstring[]Restrict to specific trader wallet addresses (max 500).
event_slugsstring[]Restrict to specific events by slug (max 500).
min_realized_pnl_usdnumberMinimum realized PnL in USD.
max_realized_pnl_usdnumberMaximum realized PnL in USD.
min_volume_usdnumberMinimum traded volume in USD.
max_volume_usdnumberMaximum traded volume in USD.
min_buy_usdnumberMinimum buy-side volume in USD.
min_sell_volume_usdnumberMinimum sell-side volume in USD.
min_markets_tradedintegerMinimum number of distinct markets traded.
timeframesstring[]One or more PnL windows: 1d, 7d, 30d, lifetime.
exclude_shortterm_marketsbooleanExclude short-term Up/Down markets.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "trader_event_pnl",
  "filters": {
    "event_slugs": ["us-presidential-election-2028"],
    "min_realized_pnl_usd": 20000,
    "min_markets_traded": 3,
    "timeframes": ["30d"]
  }
}

​
Notes

  • Combine min_realized_pnl_usd and max_realized_pnl_usd to match a PnL band rather than a single bound.
  • timeframes scopes the window over which aggregated event PnL is measured; lifetime uses the trader’s full history on the event.
Last modified on June 3, 2026