2026-06-19 - WebSocket fan-out capacity and settlement latency guidance
Expanded public WebSocket delivery capacity for heavily subscribed event streams and clarified the best subscription shape for latency-sensitive settlement consumers. What’s improved:- High-volume streams have more delivery headroom, improving resilience when many subscriptions are active at once.
- No event names, payload fields, filter syntax, or subscription messages changed.
- For the lowest settlement latency, use a dedicated
type: "settlements"subscription. The broadertype: "trades"preset intentionally multiplexessettlement,trade, andstatus_updateevents; preserving per-connection order can place a settlement behind other frames during a burst. - Initial
type: "snapshot"messages contain historical state and should be excluded when measuring livedetected_at-to-receive latency.
1ms, p90 4ms, p99 11ms, and max 50ms, with no samples above 100ms. These measurements describe that validation window, not a latency SLA.
Docs: WebSocket Overview and Settlement Event
2026-06-17 - 62-page V3 Query Catalog
Published an intent-based Query Catalog so developers can start from the result they need instead of first finding the underlying endpoint. The catalog includes category guides and granular copy-ready recipes for:- Trades: global, wallet, market-token, market-slug, builder-attributed, grouped-order, condition, and combo trade queries.
- Positions: wallet, open-wallet, global, token-holder, condition-holder, market-slug, and combo position queries.
- P&L: all-time and time-window wallet P&L, market/tag breakdowns, event history, batch reads, and leaderboards.
- Markets: search, condition and slug lookup, token details, prices, tags, resolutions, and candles.
- Wallet activity: unified activity, splits, merges, redemptions, negative-risk conversions, PolyUSD flows, fees, rebates, and rewards.
- Builders, combos, fees, tags, and categories, including additive
include_combos=truequery shapes.
2026-06-17 - Fee, rebate, and reward data guide
Published a dedicated Fees section that distinguishes the API’s accounting surfaces and points each question to the correct endpoint. Documented query paths:- Exact all-time trader-paid fees:
GET /v3/wallets/{address}?include_accounting_summary=true. - Fee-bearing wallet fills:
GET /v3/wallets/{address}/fees-paid. - Global and receiver-scoped fee events:
GET /v3/feesandGET /v3/fees/{receiver}. - Builder fee ranking and underlying attributed fills:
GET /v3/builders?sort=feesandGET /v3/builders/{code}/trades. - Maker rebates:
GET /v3/wallets/{address}/rebates. - Public reward-market configuration:
GET /v3/rewards/marketsandGET /v3/rewards/markets/{condition_id}.
page_total_fees_paidis scoped to the returned page; use the opt-in wallet accounting summary for the exact all-time total.- Fee-event raw amounts use six-decimal USDC units.
- Builder
total_feesmeans protocol fees generated by attributed fills, not an off-chain builder revenue-share payout. - Maker rebate lookups use the CLOB maker/signing address, and reward-market configuration is not a per-wallet earned-rewards ledger.
2026-06-17 - Full V3 market-candles reference
Published the complete public reference for trade-built V3 OHLCV candles across token, condition, and market-slug lookups. Documented routes:- Resolutions
1m,5m,15m,1h,4h, and1d, with maximum request sizes of 120, 180, 240, 300, 360, and 500 candle buckets respectively. - Forward and backward windows with
direction,anchor_ts,start, andend; timestamp parameters use Unix seconds. - Backward history pagination through
pagination.older_end_ts. - Optional
gap_fill=truecarry-forward candles after a prior price exists. - Token routes returning one
candlesseries, while condition and slug routes return oneseriesentry per outcome token. Usetoken_idto select one outcome from a condition or slug. - OHLC, USD/share/buy/sell volume, trade count, VWAP, millisecond chart timestamps, and first/last fill timestamps.
2026-06-15 - PM2 AutoRedeemer redemptions in WebSocket streams
PM2 AutoRedeemer redemptions are now surfaced in both the combo stream and the standard redemption stream. What’s new:- AutoRedeemer
Redemption,BinaryRedemption, andNegRiskRedemptionlogs emit customer-facingcombo_lifecycleevents with the wallet, exact raw payout, normalized payout, module name, and receipt log index. Binary and negative-risk redemptions also include the condition ID directly. - Confirmed
combo_status_updatemessages can includelifecycle_events[]for receipt-only AutoRedeemer lifecycle activity. - The same AutoRedeemer payout is also bridged into the standard
redemptionevent class, attributed to the user wallet instead of the AutoRedeemer contract. - New
type: "redemptions"WebSocket preset subscribes directly toredemptionevents. Existingsettlementsorwalletssubscriptions withevent_types: ["redemption"]continue to work.

