> ## 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

> Get notified when a trader's position resolves in a market.

<Note>
  **Event:** `trader_position_resolved` \
  **Endpoint:** `wss://api.struct.to/ws/alerts` \
  **Cost:** 0.1 credits per event
</Note>

Fires when a position held by a tracked trader reaches resolution, meaning the owning market settled and a win or loss verdict is known. The payload is the full position row with the `won` flag set. Use the `won_only` filter to receive only winning resolutions, only losing resolutions, or both.

## Filters

| Filter            | Type       | Required | Description                                                  |
| ----------------- | ---------- | -------- | ------------------------------------------------------------ |
| `traders`         | `string[]` | No       | Specific trader wallet addresses (max 500)                   |
| `condition_ids`   | `string[]` | No       | Restrict to specific markets (max 500)                       |
| `event_slugs`     | `string[]` | No       | Restrict to specific events (max 500)                        |
| `outcome_indexes` | `number[]` | No       | Restrict to specific outcome indexes                         |
| `won_only`        | `boolean`  | No       | `true` for wins only, `false` for losses only, omit for both |

## Subscribe

```json theme={null}
{
  "op": "subscribe",
  "event": "trader_position_resolved",
  "traders": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
  "won_only": true
}
```

## Response

```json theme={null}
{
  "event": "trader_position_resolved",
  "timestamp": 1775913505260,
  "data": {
    "trader": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
    "position_id": "21742633143463906290569050155826241533067272736897614950488156847949938836455",
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "market_slug": "will-candidate-x-win",
    "event_slug": "2026-us-midterm-elections",
    "title": "Will Candidate X win?",
    "question": "Will Candidate X win the 2026 election?",
    "image_url": "https://polymarket-upload.s3.us-east-2.amazonaws.com/example.png",
    "outcome": "Yes",
    "outcome_index": 0,
    "open": false,
    "won": true,
    "total_buys": 8,
    "total_sells": 2,
    "converted_count": 0,
    "converted_shares_gained": 0.0,
    "converted_shares_lost": 0.0,
    "total_shares_bought": 5000.0,
    "total_shares_sold": 1000.0,
    "total_buy_usd": 3000.00,
    "total_sell_usd": 700.00,
    "redemption_usd": 4000.00,
    "merge_usd": 0.00,
    "avg_entry_price": 0.60,
    "avg_exit_price": 0.70,
    "avg_price": 0.62,
    "realized_pnl_usd": 1700.00,
    "realized_pnl_pct": 56.67,
    "total_fees": 25.00,
    "first_trade_at": 1712966400000,
    "last_trade_at": 1713052800000,
    "current_price": 1.0,
    "current_shares_balance": 4000.0,
    "current_value": 4000.00,
    "last_traded_price": 0.70,
    "end_date": 1781620700,
    "is_neg_risk": false,
    "redeemable": true,
    "mergeable": false,
    "dirty_kinds": ["position_resolved"]
  }
}
```