First trade callback

{ "trader": "<string>", "taker": "<string>", "position_id": "<string>", "trade_id": "<string>", "hash": "<string>", "block": 123, "confirmed_at": 123, "amount_usd": 123, "shares_amount": 123, "fee": 123, "side": "Buy", "price": 0.5, "exchange": "<string>", "trade_type": "<string>", "condition_id": "<string>", "outcome": "<string>", "outcome_index": 123, "question": "<string>", "market_slug": "<string>", "event_slug": "<string>" }

Body

application/json

Payload delivered when a tracked trader executes their first-ever trade on Polymarket

trader

string

required

Limit-order maker wallet address (lowercase)

taker

string

required

Order filler wallet address (lowercase)

position_id

string

required

ERC-1155 outcome token ID

trade_id

string

required

Unique trade identifier

hash

string

required

Transaction hash

block

integer<int64>

required

Block number

confirmed_at

integer<int64>

required

Block confirmation timestamp (Unix seconds)

amount_usd

number

required

USD size of the trade (6 decimal places)

shares_amount

number

required

Outcome shares traded (6 decimal places)

fee

number

required

Fee paid in USD (6 decimal places)

side

enum<string>

required

Trade direction

Available options:

Buy,

Sell

price

number

required

Outcome token price (0.0–1.0)

Required range: 0 <= x <= 1

exchange

string

required

Exchange identifier

trade_type

string

required

Trade type identifier

condition_id

string | null

Parent market condition ID (0x-prefixed hex)

outcome

string | null

Outcome name (e.g. "Yes", "No")

outcome_index

integer | null

Outcome index: 0 = Yes/Up, 1 = No

question

string | null

Market question text

market_slug

string | null

Market slug

event_slug

string | null

Parent event slug

Response

Webhook delivery acknowledged

Introduction

Webhooks

Webhook Callbacks

Body

Response