Trader New Trade

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

Fires on every order-filled trade that matches the configured filters. Unlike trader_first_trade or trader_new_market, this event triggers for all qualifying trades, making it suitable for continuous trade monitoring.

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 fill trade types (e.g. `OrderFilled`, `OrdersMatched`) (max 500)
`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_new_trade",
  "wallet_addresses": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
  "condition_ids": ["0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b"],
  "min_usd_value": 50
}

Response

{
  "event": "trader_new_trade",
  "timestamp": 1775913505260,
  "data": {
    "trader": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
    "taker": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
    "position_id": "24680",
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "outcome": "No",
    "outcome_index": 1,
    "question": "Will the Fed cut rates in June 2026?",
    "market_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",
    "trade_id": "ghi789",
    "hash": "0x9876543210fedcba9876543210fedcba9876543210fedcba9876543210fedcba",
    "block": 58321200,
    "confirmed_at": 1713019500,
    "amount_usd": 750,
    "shares_amount": 1875.00,
    "fee": 1.50,
    "side": "Sell",
    "price": 0.40,
    "probability": 0.60,
    "exchange": "Polymarket",
    "trade_type": "OrderFilled"
  }
}

price and probability are not the same field:

price: the outcome you are looking at (the token in outcome_index / position_id).
probability: always outcome index 0 (the Yes/Up token), no matter which outcome the payload is about.

They are equal only when outcome_index is 0. On the No side (index 1) they are complements: a price of 0.40 pairs with a probability of 0.60.

Introduction

Rooms

Alerts

Filters

Response

​Filters

​Subscribe

​Response

Filters

Subscribe

Response