Skip to main content
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.
FilterTypeDescription
wallet_addressesstring[]Restrict to specific trader wallet addresses (max 500).
min_usd_valuenumberMinimum USD size of the trade.
min_probabilitynumberMinimum outcome probability, 0.0–1.0.
max_probabilitynumberMaximum outcome probability, 0.0–1.0.
condition_idsstring[]Restrict to specific markets by condition ID (max 500).
event_slugsstring[]Restrict to specific events by slug (max 500).
trade_typesstring[]Restrict to specific trade types, e.g. OrderFilled, Redemption, Merge, Split (max 500).
exclude_shortterm_marketsbooleanExclude 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 3, 2026