Trader Trade Event

Event: trader_trade_event
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event

Fires on every confirmed prediction trade. Unlike trader_new_trade, this alert delivers a typed discriminated-union payload that covers all trade variants (OrderFilled, Redemption, Merge, Split, PositionsConverted, Cancelled, oracle lifecycle, and more) with the correct fields per variant.

Filters

Filter	Type	Required	Description
`wallet_addresses`	`string[]`	No	Restrict to 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)
`trade_types`	`string[]`	No	Restrict to specific trade variants (e.g. `OrderFilled`, `Redemption`, `Merge`, `Split`)
`min_usd_value`	`number`	No	Minimum trade size in USD
`min_price`	`number`	No	Minimum probability threshold (0.0 to 1.0)
`max_price`	`number`	No	Maximum probability threshold (0.0 to 1.0)
`exclude_shortterm_markets`	`boolean`	No	Exclude short-term “updown” markets

{
  "op": "subscribe",
  "event": "trader_trade_event",
  "wallet_addresses": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
  "condition_ids": ["0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b"],
  "min_usd_value": 50,
  "exclude_shortterm_markets": true
}

Response

The data object is a discriminated union keyed on trade_type. The OrderFilled variant is shown below; Redemption, Merge, Split, PositionsConverted, Cancelled, and the oracle lifecycle variants follow the same shapes documented for the Trades room.

{
  "event": "trader_trade_event",
  "timestamp": 1743500000000,
  "data": {
    "trade_type": "OrderFilled",
    "id": "0xabc123def456",
    "hash": "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba",
    "block": 65000000,
    "confirmed_at": 1700000000,
    "log_index": 0,
    "block_index": 0,
    "order_hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
    "trader": {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    },
    "taker": "0x0000000000000000000000000000000000000000",
    "side": "Buy",
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "position_id": "452312848583266388373324160190187140051835877600158453279131187530910662656",
    "outcome": "Yes",
    "outcome_index": 0,
    "question": "Will the Fed cut rates in June 2026?",
    "slug": "will-the-fed-cut-rates-in-june-2026",
    "event_slug": "fed-rate-decisions-2026",
    "image_url": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-the-fed-cut-rates-in-june-2026.png",
    "usd_amount": 25.0,
    "shares_amount": 50.0,
    "price": 0.5,
    "probability": 0.5,
    "fee": 0.025,
    "fee_shares": 0.0,
    "fee_pct": 0.1,
    "exchange": "CTFExchange",
    "builder_code": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "builder_fee": 0.0
  }
}

builder_code is the lower-cased 0x... bytes32 identifier of the integrator that brokered the order (CLOB v2 only). 0x0000… means the order was placed directly through Polymarket. Both builder_code and builder_fee are omitted on v1 trades. See Fetching trades by builder code.

Introduction

Rooms

Alerts

Filters

Response

​Filters

​Subscribe

​Response

Filters

Subscribe

Response