Event: trader_position_resolved
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event
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
{
"op": "subscribe",
"event": "trader_position_resolved",
"traders": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
"won_only": true
}
Response
{
"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"]
}
}
