Global pnl callback

{ "timeframe": "1d", "trader": "<string>", "realized_pnl_usd": 123, "events_traded": 123, "markets_traded": 123, "total_buys": 123, "total_sells": 123, "total_redemptions": 123, "total_merges": 123, "total_volume_usd": 123, "buy_volume_usd": 123, "sell_volume_usd": 123, "redemption_volume_usd": 123, "merge_volume_usd": 123, "markets_won": 123, "markets_lost": 123, "market_win_rate_pct": 123, "avg_pnl_per_market": 123, "avg_pnl_per_trade": 123, "avg_hold_time_seconds": 123, "total_fees": 123, "best_trade_pnl_usd": 123, "best_trade_condition_id": "<string>", "worst_trade_pnl_usd": 123, "worst_trade_condition_id": "<string>", "first_trade_at": 123, "last_trade_at": 123 }

Body

application/json

Payload delivered when a trader's global PnL (across all markets) crosses a configured threshold

timeframe

enum<string>

required

PnL aggregation window

Available options:

1d,

7d,

30d,

lifetime

trader

string | null

Trader wallet address (lowercase)

realized_pnl_usd

number | null

Realized PnL in USD (positive = profit, negative = loss)

events_traded

integer<int64> | null

Number of distinct events traded

markets_traded

integer<int64> | null

Number of distinct markets traded

total_buys

integer<int64> | null

Total buy transactions

total_sells

integer<int64> | null

Total sell transactions

total_redemptions

integer<int64> | null

Total redemption transactions

total_merges

integer<int64> | null

Total merge transactions

total_volume_usd

number | null

Total USD volume (buys + sells + redemptions + merges)

buy_volume_usd

number | null

Total buy volume in USD

sell_volume_usd

number | null

Total sell volume in USD

redemption_volume_usd

number | null

Total redemption volume in USD

merge_volume_usd

number | null

Total merge volume in USD

markets_won

integer<int64> | null

Number of markets where trader realised a profit

markets_lost

integer<int64> | null

Number of markets where trader realised a loss

market_win_rate_pct

number | null

Market win rate as a percentage (0.0–100.0)

avg_pnl_per_market

number | null

Average PnL per market in USD

avg_pnl_per_trade

number | null

Average PnL per trade in USD

avg_hold_time_seconds

number | null

Average hold time across all positions (seconds)

total_fees

number | null

Total fees paid in USD

best_trade_pnl_usd

number | null

Best single-trade PnL in USD

best_trade_condition_id

string | null

Condition ID of the best trade

worst_trade_pnl_usd

number | null

Worst single-trade PnL in USD

worst_trade_condition_id

string | null

Condition ID of the worst trade

first_trade_at

integer<int64> | null

Timestamp of the first trade (Unix seconds)

last_trade_at

integer<int64> | null

Timestamp of the most recent trade (Unix seconds)

Response

Webhook delivery acknowledged

Introduction

Webhooks

Webhook Callbacks

Body

Response