Trader First Trade

Event: trader_first_trade
Cost: 0.1 credits per delivery

The trader_first_trade event fires when a tracked trader executes their first-ever trade on Polymarket, delivering exactly once per trader for the lifetime of their account. The full payload schema is in the auto-generated Trader First Trade callback reference; this page documents the filters and matching behavior.

When to use this

Onboard newly active wallets into a watchlist the moment they place their debut trade.
Detect fresh capital entering Polymarket before a trader builds any history.
Trigger welcome or attribution flows that should run once per trader, never on repeat trades.

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_first_trade",
  "filters": {
    "min_usd_value": 100,
    "exclude_shortterm_markets": true
  }
}

Last modified on June 16, 2026

Use Cases

Trader New Market

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