Trader Whale Trade

Event: trader_whale_trade
Cost: 0.2 credits per delivery

The trader_whale_trade event fires when a trade exceeds the configured size and optional probability thresholds. The full payload schema is in the auto-generated Trader Whale 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

Surface only the large, market-moving trades from a watched set of wallets.
Gate alerts to high-conviction positions by pairing size with a probability band.
Cut noise from small fills so your feed carries just the whale-sized activity.

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).
`exclude_shortterm_markets`	boolean	Exclude short-term Up/Down markets.

Example

{
  "url": "https://your-server.com/webhooks",
  "event": "trader_whale_trade",
  "filters": {
    "min_usd_value": 10000,
    "min_price": 0.1,
    "max_price": 0.9
  }
}

Notes

Set min_usd_value to define what counts as a whale-sized trade; without it there is no size floor and every trade matches.
The probability filters are optional and narrow matches to a specific confidence band.

Last modified on June 16, 2026

Trader Trade Event

Trader Global PnL

Introduction

Trader events

Metrics

Holders

Milestones

Spikes

Market lifecycle

Asset prices

Webhooks

Webhook Callbacks

When to use this

Subscription filters

Example

Notes

​When to use this

​Subscription filters

​Example

​Notes

When to use this

Subscription filters

Example

Notes