Wallet Positions: Per-Position Net Fees
New Field: net_fees_usd
The
PositionDetails schema now includes net_fees_usd — net taker fees charged for each individual position (charged minus refunded, in USD). Previously, fee data was only available at the wallet summary level.fees_refunded Deprecated
The fees_refunded field now always returns 0 across all schemas. Refunds are already netted into fees_paid, making the separate field redundant.Affected schemas
Affected schemas
| Schema | Field |
|---|---|
PositionsSummary | fees_refunded |
AllTimeMetrics | fees_refunded |
WindowMetrics | fees_refunded |
CohortStats | avg_fees_refunded, total_fees_refunded |
WalletPnLResponse | fees_refunded |
Candlesticks: All-Time Range for Daily Interval
The1d candlestick interval no longer has a range limit. Omit start_time and end_time to fetch the full history.| Interval | Max Range |
|---|---|
1m | 7 days |
1h | 30 days |
1d | Unlimited (all-time) |
WebSocket: Oracle Channel
New Channel: oracle
Real-time UMA oracle resolution events for Polymarket markets — proposals, settlements, disputes, and resets.
- Subscribe by
condition_idsormarket_slugs. Wildcard (["*"]) supported. - Event types:
proposal,settled,dispute,reset. - Enrichment fields:
title,market_slug,image,outcomes,tokens,is_neg_risk.
WebSocket: Orderbook Channel
New Channel: orderbook
Real-time L2 orderbook data from Polymarket’s CLOB — snapshots, price changes, and last trades.
- Subscribe by
token_ids,condition_ids, ormarket_slugs. Wildcard (["*"]) supported. - Targeted subscriptions deliver individual events. Wildcard delivers 250ms batched events with price-level conflation.
- Event types:
book_snapshot,price_change,last_trade,tick_size_change,snapshots_done,event_batch,resync.