Trader Global PnL

Event: trader_global_pnl
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event

Fires when a trader’s aggregated global profit and loss crosses the configured thresholds. This event covers the trader’s entire Polymarket portfolio, making it useful for monitoring overall performance of specific wallets.

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)

{
  "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
  }
}

Last modified on April 13, 2026

Trader Whale Trade

Trader Market PnL

Introduction

Rooms

Alerts

Filters

Response

​Filters

​Subscribe

​Response

Filters

Subscribe

Response