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

# Trader Position Resolved

> Fire a webhook when a trader's position resolves as its market settles.

<Note>
  **Event:** `trader_position_resolved` \
  **Cost:** 0.1 credits per delivery
</Note>

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](/api-reference/webhook-callbacks/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.

| 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).                                                       |
| `outcome_indexes` | integer\[] | Restrict to specific outcome indexes within a market.                                                |
| `won_only`        | boolean    | When `true`, deliver only winning resolutions; when `false`, only losing ones. Omit to receive both. |

## Example

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