pnl_change

Fires when a wallet’s realized PnL changes. Track profit milestones, loss alerts, and performance shifts.

Filters

Filter	Type	Required	Description
wallet_addresses	string[]	Yes	Wallets to watch. Max 500.
min_pnl_change_usd	number	Recommended	Minimum PnL delta to trigger.

Payload

{
  "id": "evt_b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
  "type": "pnl_change",
  "created_at": "2026-05-14T15:15:00.000000000+00:00",
  "data": {
    "wallet": "0xdb27bf2ac5d428a9c63dbc910c5e6e75560c0ae5",
    "token_id": "83970135942868582996575481879514955574496723508450032076038091728966335782753",
    "realized_pnl": 22053845.83,
    "market": "Will Bitcoin hit $100k by 2026?",
    "outcome": "Yes"
  }
}

Use Cases

• Leader tracking: alert when top traders cross PnL milestones
• Risk monitoring: detect sudden losses in watched portfolios
• Copy-trading signals: PnL changes indicate trade activity