Skip to main content
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.
FilterTypeDescription
tradersstring[]Restrict to specific trader wallet addresses (max 500).
condition_idsstring[]Restrict to specific markets by condition ID (max 500).
event_slugsstring[]Restrict to specific events by slug (max 500).

​
Exit reasons

Each delivery carries a reason describing how the position was closed:
ReasonMeaning
resolved_winHeld to market resolution and won by the market verdict.
resolved_lossHeld to market resolution and lost by the market verdict.
sold_winClosed before resolution with positive realized PnL.
sold_lossClosed 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 June 13, 2026