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

> Receive a typed prediction-trade stream of a tracked trader's trade events.

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

The `trader_trade_event` event delivers a typed prediction-trade stream of a tracked trader's trade events, with each delivery carrying the structured event type. The full payload schema is in the auto-generated [Trader Trade Event callback](/api-reference/webhook-callbacks/typed-trade-event-callback) reference; this page documents the filters and matching behavior.

## When to use this

* Consume a structured, typed event feed rather than raw fills for downstream classification.
* Branch your handling logic on trade type while keeping a single subscription.
* Feed a normalized prediction-trade timeline into dashboards or alerting systems.

## 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 trade types, e.g. `OrderFilled`, `Redemption`, `Merge`, `Split` (max 500). |
| `exclude_shortterm_markets` | boolean | Exclude short-term Up/Down markets. |

## Example

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.