Trader Trade Event

Event: trader_trade_event
Cost: 0.2 credits per delivery

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

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

Last modified on June 16, 2026

Trader New Trade

Trader Whale Trade

Introduction

Trader events

Metrics

Holders

Milestones

Spikes

Market lifecycle

Asset prices

Webhooks

Webhook Callbacks

When to use this

Subscription filters

Example

​When to use this

​Subscription filters

​Example

When to use this

Subscription filters

Example