Room ID: polymarket_trader_positions
Endpoint: wss://api.struct.to/ws
Rate: 0.005 credits per message
Subscribe
The traders filter is required. Provide one or more wallet addresses (0x-prefixed) to track.
Filters
| Filter | Type | Required | Description |
|---|
traders | string[] | Yes | Wallet addresses to track (0x-prefixed) |
Example
{
"type": "join_room",
"payload": {
"room_id": "polymarket_trader_positions"
}
}
{
"type": "room_message",
"payload": {
"room_id": "polymarket_trader_positions",
"message": {
"action": "subscribe",
"traders": ["0x1234567890abcdef1234567890abcdef12345678"]
}
}
}
Response
{
"type": "trader_positions_stream_subscribe_response",
"room_id": "polymarket_trader_positions",
"data": {
"traders": ["0x1234567890abcdef1234567890abcdef12345678"],
"rejected": []
}
}
Events
trader_position_update
{
"type": "trader_position_update",
"room_id": "polymarket_trader_positions",
"data": {
"trader": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"position_id": "12345678901234567",
"condition_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"market_slug": "will-bitcoin-hit-100k",
"event_slug": "bitcoin-price-markets",
"title": "Will Bitcoin hit $100k?",
"image_url": "https://polymarket.com/images/market.png",
"outcome": "Yes",
"outcome_index": 0,
"won": null,
"total_buys": 3,
"total_sells": 1,
"total_shares_bought": 1500.0,
"total_shares_sold": 500.0,
"total_buy_usd": 975.00,
"total_sell_usd": 350.00,
"redemption_usd": 0.0,
"avg_entry_price": 0.65,
"avg_exit_price": 0.70,
"realized_pnl_usd": 125.50,
"total_fees": 2.65,
"first_trade_at": 1742000000,
"last_trade_at": 1743500000,
"current_shares_balance": 1000.0,
"realized_pnl_pct": 12.87
}
}
