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

When to use this

  • Alert when a trader’s combined PnL across a market category (such as Politics or Sports) clears a profit or loss threshold.
  • Track category-level specialization by scoping to the categories a trader is active in rather than individual markets.
  • Qualify category conviction by pairing PnL bounds with volume, win rate, and the number of distinct markets traded.

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 aggregated category PnL is measured; lifetime uses the trader’s full history in that category.
Last modified on July 13, 2026