Trader New Market

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

Fires when a trader executes their first trade in a market they have not previously participated in. This is useful for tracking when known wallets expand into new markets or when specific markets attract new participants.

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)
`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_market",
  "wallet_addresses": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
  "min_usd_value": 500,
  "exclude_shortterm_markets": true
}

Response

{
  "event": "trader_new_market",
  "timestamp": 1775913505260,
  "data": {
    "trader": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
    "taker": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
    "position_id": "67890",
    "condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
    "outcome": "Yes",
    "outcome_index": 0,
    "question": "Will Bitcoin reach $150k by July 2026?",
    "market_slug": "will-bitcoin-reach-150k-by-july-2026",
    "event_slug": "bitcoin-price-milestones",
    "trade_id": "def456",
    "hash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
    "block": 58321100,
    "confirmed_at": 1713016200,
    "amount_usd": 2500,
    "shares_amount": 3846.15,
    "fee": 5.00,
    "side": "Buy",
    "price": 0.65,
    "probability": 0.65,
    "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.

Last modified on June 16, 2026

Trader First Trade

Trader New Trade

Introduction

Rooms

Alerts

Filters

Response

​Filters

​Subscribe

​Response

Filters

Subscribe

Response