Event: trader_global_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) |
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 |
min_win_rate | number | No | Minimum win rate percentage (0.0 to 100.0) |
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 |
timeframes | string[] | No | Timeframe windows: 1d, 7d, 30d, lifetime (max 500) |
Subscribe
{
"op": "subscribe",
"event": "trader_global_pnl",
"traders": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
"min_realized_pnl_usd": 5000,
"min_win_rate": 60
}
Response
{
"event": "trader_global_pnl",
"timestamp": 1775913505260,
"data": {
"trader": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
"timeframe": "lifetime",
"realized_pnl_usd": 12500.75,
"events_traded": 45,
"markets_traded": 82,
"total_buys": 320,
"total_sells": 180,
"total_redemptions": 55,
"total_merges": 12,
"total_volume_usd": 250000.00,
"buy_volume_usd": 175000.00,
"sell_volume_usd": 50000.00,
"redemption_volume_usd": 20000.00,
"merge_volume_usd": 5000.00,
"markets_won": 52,
"markets_lost": 30,
"market_win_rate_pct": 63.41,
"avg_pnl_per_market": 152.45,
"avg_pnl_per_trade": 25.00,
"avg_hold_time_seconds": 604800.0,
"total_fees": 500.00,
"best_trade_pnl_usd": 3200.00,
"best_trade_condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
"first_trade_at": 1736929800,
"last_trade_at": 1781620700
}
}
