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.

Example

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 13, 2026