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_probability | number | No | Minimum probability threshold (0.0 to 1.0) |
max_probability | number | No | Maximum probability threshold (0.0 to 1.0) |
exclude_shortterm_markets | boolean | No | Exclude 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"
}
}