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

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)
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_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"
  }
}
Last modified on April 13, 2026