Event: trader_first_trade
Endpoint: wss://api.struct.to/ws/alerts
Cost: 0.1 credits per event
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_first_trade",
"wallet_addresses": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
"min_usd_value": 100
}
Response
{
"event": "trader_first_trade",
"timestamp": 1775913505260,
"data": {
"trader": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
"taker": "0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec",
"position_id": "12345",
"condition_id": "0x4fec624c0ff2bfae89956cebd6fbc9c58f995f824382dc587dc5a32a4b15940b",
"outcome": "Yes",
"outcome_index": 0,
"question": "Will the Virginia constitutional amendment referendum fail to pass?",
"market_slug": "will-the-virginia-constitutional-amendment-referendum-fail-to-pass",
"event_slug": "virginia-constitutional-amendment-referendum",
"trade_id": "abc123",
"hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"block": 58321045,
"confirmed_at": 1713012000,
"amount_usd": 199,
"shares_amount": 970.73,
"fee": 0.40,
"side": "Buy",
"price": 0.2048,
"exchange": "Polymarket",
"trade_type": "OrderFilled"
}
}
