Trader New Market

Event: trader_new_market
Cost: 0.1 credits per delivery

The trader_new_market event fires the first time a trader trades in a specific market, delivering once per trader-and-market pair. The full payload schema is in the auto-generated Trader New Market 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

Track when a trader expands into a market they have never touched before.
Spot smart money rotating into a fresh event or condition for the first time.
Build per-market entry alerts without re-firing on subsequent trades in the same market.

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).
`condition_ids`	string[]	Restrict to specific markets by condition ID (max 500).
`event_slugs`	string[]	Restrict to specific events by slug (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`.
`exclude_shortterm_markets`	boolean	Exclude short-term Up/Down markets.

Example

{
  "url": "https://your-server.com/webhooks",
  "event": "trader_new_market",
  "filters": {
    "wallet_addresses": ["0x1f98431c8ad98523631ae4a59f267346ea31f984"],
    "min_usd_value": 50
  }
}

Last modified on June 16, 2026

Trader First Trade

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