> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polynode.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```json theme={null}
{
  "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