Skip to main content
Event: trader_position_resolved
Cost: 0.1 credits per delivery
Fires when a trader’s position resolves, that is, when the market backing the position settles and the win or loss is final. The full payload schema is in the auto-generated Trader Position Resolved callback reference; this page documents the filters and matching behavior.

​
When to use this

  • Book final outcomes for a watchlist of traders the moment their positions settle.
  • Reconcile open positions to closed at resolution time without polling.
  • Track only winning resolutions (or only losing ones) by combining the resolution event with the won_only filter.

​
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).
outcome_indexesinteger[]Restrict to specific outcome indexes within a market.
won_onlybooleanWhen true, deliver only winning resolutions; when false, only losing ones. Omit to receive both.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "trader_position_resolved",
  "filters": {
    "traders": ["0xabc1230000000000000000000000000000000000"],
    "won_only": true
  }
}

​
Notes

  • The payload is the full resolved position, including the resolved outcome, realized PnL, and cost basis.
  • The event fires once per position when its market resolves; it does not fire on intermediate trades or price moves.
  • Omit won_only to receive every resolution regardless of whether the position won or lost.
Last modified on June 13, 2026