Skip to main content
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

FilterTypeRequiredDescription
wallet_addressesstring[]NoRestrict to specific trader wallet addresses (max 500)
condition_idsstring[]NoRestrict to specific markets (max 500)
event_slugsstring[]NoRestrict to specific events (max 500)
trade_typesstring[]NoRestrict to specific trade variants (e.g. OrderFilled, Redemption, Merge, Split)
min_usd_valuenumberNoMinimum trade size in USD
min_probabilitynumberNoMinimum probability threshold (0.0 to 1.0)
max_probabilitynumberNoMaximum probability threshold (0.0 to 1.0)
exclude_shortterm_marketsbooleanNoExclude short-term “updown” markets

​
Subscribe

{
  "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",
    "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"
  }
}
Last modified on April 25, 2026