> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Trader First Trade

> Get notified when a trader executes their first-ever trade on Polymarket.

<Note>
  **Event:** `trader_first_trade` \
  **Endpoint:** `wss://api.struct.to/ws/alerts` \
  **Cost:** 0.1 credits per event
</Note>

Fires the first time a wallet address executes a trade on Polymarket. This is useful for tracking new market participants or detecting when monitored wallets become active for the first time.

## 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                    |

## Subscribe

```json theme={null}
{
  "op": "subscribe",
  "event": "trader_first_trade",
  "wallet_addresses": ["0x37BA57e2942A57F05B5E4BCFD4d027845cFC40ec"],
  "min_usd_value": 100
}
```

## Response

```json theme={null}
{
  "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",
    "image_url": "https://polymarket-upload.s3.us-east-2.amazonaws.com/will-the-virginia-constitutional-amendment-referendum-fail-to-pass.png",
    "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"
  }
}
```