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

> Fire a webhook the very first time a tracked trader ever trades on Polymarket.

<Note>
  **Event:** `trader_first_trade` \
  **Cost:** 0.1 credits per delivery
</Note>

The `trader_first_trade` event fires when a tracked trader executes their first-ever trade on Polymarket, delivering exactly once per trader for the lifetime of their account. The full payload schema is in the auto-generated [Trader First Trade callback](/api-reference/webhook-callbacks/first-trade-callback) reference; this page documents the filters and matching behavior.

## When to use this

* Onboard newly active wallets into a watchlist the moment they place their debut trade.
* Detect fresh capital entering Polymarket before a trader builds any history.
* Trigger welcome or attribution flows that should run once per trader, never on repeat trades.

## Subscription filters

Add these to the `filters` object when you create the subscription.

| Filter                      | Type      | Description                                             |
| --------------------------- | --------- | ------------------------------------------------------- |
| `wallet_addresses`          | string\[] | Restrict to specific trader wallet addresses (max 500). |
| `min_usd_value`             | number    | Minimum USD size of the trade.                          |
| `min_price`                 | number    | Minimum outcome probability, `0.0`–`1.0`.               |
| `max_price`                 | number    | Maximum outcome probability, `0.0`–`1.0`.               |
| `condition_ids`             | string\[] | Restrict to specific markets by condition ID (max 500). |
| `event_slugs`               | string\[] | Restrict to specific events by slug (max 500).          |
| `exclude_shortterm_markets` | boolean   | Exclude short-term Up/Down markets.                     |

## Example

```json theme={null}
{
  "url": "https://your-server.com/webhooks",
  "event": "trader_first_trade",
  "filters": {
    "min_usd_value": 100,
    "exclude_shortterm_markets": true
  }
}
```