Skip to main content
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.

​
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.
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).
exclude_shortterm_marketsbooleanExclude short-term Up/Down markets.

​
Example

{
  "url": "https://your-server.com/webhooks",
  "event": "trader_whale_trade",
  "filters": {
    "min_usd_value": 10000,
    "min_probability": 0.1,
    "max_probability": 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 3, 2026