Event: trader_event_pnl
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event
Filters
| Filter | Type | Required | Description |
|---|
traders | string[] | No | Specific trader wallet addresses (max 500) |
event_slugs | string[] | No | Restrict to specific events (max 500) |
min_realized_pnl_usd | number | No | Minimum realized PnL in USD |
max_realized_pnl_usd | number | No | Maximum realized PnL in USD |
min_volume_usd | number | No | Minimum total volume in USD |
max_volume_usd | number | No | Maximum total volume in USD |
min_buy_usd | number | No | Minimum buy volume in USD |
min_sell_volume_usd | number | No | Minimum sell volume in USD |
min_markets_traded | number | No | Minimum number of markets traded within the event |
timeframes | string[] | No | Timeframes to track (valid: 1d, 7d, 30d, lifetime) |
exclude_shortterm_markets | boolean | No | Exclude short-term “updown” markets |
Subscribe
{
"op": "subscribe",
"event": "trader_event_pnl",
"traders": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
"min_realized_pnl_usd": 2000,
"min_markets_traded": 3
}
Response
{
"event": "trader_event_pnl",
"timestamp": 1775913505260,
"data": {
"trader": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
"event_slug": "2026-us-midterm-elections",
"timeframe": "7d",
"markets_traded": 5,
"outcomes_traded": 8,
"total_buys": 45,
"total_sells": 30,
"total_redemptions": 10,
"total_merges": 3,
"total_volume_usd": 75000.00,
"buy_usd": 50000.00,
"sell_usd": 15000.00,
"redemption_usd": 8000.00,
"merge_usd": 2000.00,
"realized_pnl_usd": 8500.25,
"winning_markets": 4,
"losing_markets": 1,
"total_fees": 150.00,
"first_trade_at": 1712966400,
"last_trade_at": 1713052800
}
}
