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

​
When to use this

  • Surface traders whose all-market realized PnL clears a profit or loss threshold.
  • Track aggregate performance of a watchlist of wallets across every market they touch.
  • Qualify high-conviction traders by combining global PnL with volume, win rate, and breadth of 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).
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_win_ratenumberMinimum win rate, 0.0–100.0.
min_markets_tradedintegerMinimum number of distinct markets traded.
timeframesstring[]One or more PnL windows: 1d, 7d, 30d, lifetime.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "trader_global_pnl",
  "filters": {
    "min_realized_pnl_usd": 10000,
    "min_win_rate": 60.0,
    "min_markets_traded": 5,
    "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 realized PnL is measured; lifetime uses the trader’s full history.
Last modified on June 3, 2026