Event: trader_new_trade
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.2 credits per event
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) |
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_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",
"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"
}
}
