Trader New Trade

Event: trader_new_trade
Cost: 0.2 credits per delivery

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 reference; this page documents the filters and matching behavior.

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.

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

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

Last modified on June 16, 2026

Trader New Market

Trader Trade Event

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