Trader PnL Exits

Event: trader_pnl_exits
Cost: 0.025 credits per delivery

Fires once each time a trader closes a position, carrying the realized PnL at exit and a reason describing how the position was closed. The full payload schema is in the auto-generated Trader PnL Exits callback reference; this page documents the filters and matching behavior.

When to use this

Overlay exit markers on a trader’s PnL chart as positions are closed.
Distinguish positions held to resolution from those sold early using the exit reason.
Stream realized outcomes for a watchlist of traders, markets, or events as they happen.

Subscription filters

Add these to the filters object when you create the subscription.

Filter	Type	Description
`traders`	string[]	Restrict to specific trader wallet addresses (max 500).
`condition_ids`	string[]	Restrict to specific markets by condition ID (max 500).
`event_slugs`	string[]	Restrict to specific events by slug (max 500).

Exit reasons

Each delivery carries a reason describing how the position was closed:

Reason	Meaning
`resolved_win`	Held to market resolution and won by the market verdict.
`resolved_loss`	Held to market resolution and lost by the market verdict.
`sold_win`	Closed before resolution with positive realized PnL.
`sold_loss`	Closed before resolution with negative realized PnL.

The resolved_* reasons reflect the settled market outcome, while the sold_* reasons reflect the sign of realized PnL on an early exit.

Example

{
  "url": "https://your-server.com/webhooks",
  "event": "trader_pnl_exits",
  "filters": {
    "traders": ["0xabc1230000000000000000000000000000000000"],
    "event_slugs": ["us-presidential-election-2028"]
  }
}

Notes

One delivery is sent per position close, so a trader who exits several positions produces several events.
The payload includes realized PnL in USD and as a percentage, the cost basis, and the exit reason.

Last modified on July 13, 2026

Trader Position Resolved

Condition Metrics

Introduction

Trader events

Metrics

Holders

Milestones

Spikes

Market lifecycle

Asset prices

Webhooks

Webhook Callbacks

When to use this

Subscription filters

Exit reasons

Example

Notes

​When to use this

​Subscription filters

​Exit reasons

​Example

​Notes

When to use this

Subscription filters

Exit reasons

Example

Notes