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

> Fire a webhook on every order-filled trade by a tracked trader.

<Note>
  **Event:** `trader_new_trade` \
  **Cost:** 0.2 credits per delivery
</Note>

The `trader_new_trade` event fires on every order-filled trade by a tracked trader, delivering once per fill. The full payload schema is in the auto-generated [Trader New Trade callback](/api-reference/webhook-callbacks/new-trade-callback) reference; this page documents the filters and matching behavior.

<Note>
  **`price` and `probability` are not the same field:**

  * **`price`**: the outcome you are looking at (the token in `outcome_index` / `position_id`).
  * **`probability`**: always outcome index `0` (the Yes/Up token), no matter which outcome the payload is about.

  They are equal only when `outcome_index` is `0`. On the No side (index `1`) they are complements: a `price` of `0.40` pairs with a `probability` of `0.60`.
</Note>

## When to use this

* Mirror a trader's full activity into your own ledger or analytics pipeline.
* Drive copy-trading logic that reacts to each individual fill.
* Stream a real-time feed of a watched wallet's buys and sells, optionally narrowed by trade type.

## 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).                                   |
| `trade_types`               | string\[] | Restrict to specific fill trade types: `OrderFilled`, `OrdersMatched` (max 500). |
| `exclude_shortterm_markets` | boolean   | Exclude short-term Up/Down markets.                                              |

## Example

```json theme={null}
{
  "url": "https://your-server.com/webhooks",
  "event": "trader_new_trade",
  "filters": {
    "wallet_addresses": ["0x1f98431c8ad98523631ae4a59f267346ea31f984"],
    "trade_types": ["OrderFilled"],
    "min_usd_value": 25
  }
}
```