Skip to main content
Event: trader_market_pnl
Cost: 0.1 credits per delivery
Fires when a trader’s realized PnL in a specific market (condition) crosses your configured bounds. The full payload schema is in the auto-generated Trader Market PnL callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Alert when a trader books a target profit or loss inside a single market you care about.
  • Scope PnL tracking to specific condition IDs or event slugs instead of a trader’s whole book.
  • Spot outsized per-market wins or drawdowns by pairing PnL bounds with volume filters.

​
Subscription filters

Add these to the filters object when you create the subscription.
FilterTypeDescription
tradersstring[]Restrict to specific trader wallet addresses (max 500).
condition_idsstring[]Restrict to specific markets by condition ID (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.
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_market_pnl",
  "filters": {
    "condition_ids": ["0x1234abcd5678ef901234abcd5678ef901234abcd5678ef901234abcd5678ef90"],
    "min_realized_pnl_usd": 5000,
    "min_volume_usd": 25000,
    "timeframes": ["7d"]
  }
}

​
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 per-market realized PnL is measured; lifetime uses the trader’s full history in that market.
Last modified on June 3, 2026