Changelog

March 2026

March 15, 2026

New Endpoints

Category	Endpoint	Description
Limitless	`GET /v2/limitless/orderbooks`	Historical orderbook snapshots for Limitless markets
Opinion	`GET /v2/opinion/orderbooks`	Historical orderbook snapshots for Opinion markets
Predict.Fun	`GET /v2/predictfun/orderbooks`	Historical orderbook snapshots for Predict.Fun markets

All three endpoints return YES-side orderbook data with cursor pagination. Timestamps in milliseconds.

Kalshi Orderbook Data Gap

Kalshi orderbook data is unavailable between March 12 08:00 UTC and March 14 18:10 UTC due to an upstream Kalshi API format change. Data before and after this window is unaffected.

March 7, 2026

WebSocket: Pending Trades Channel

Added pending-trades channel to the WebSocket API, delivering real-time pending trade events before they are confirmed on-chain.

February 2026

February 20, 2026

WebSocket: Trade Event Payload Update

The order_filled event on the trades channel now includes four new fields:

Field	Type	Description
`outcome_index`	number \| null	`0` = first outcome (Yes/Over/Up), `1` = second outcome (No/Under/Down)
`complement_token_id`	string \| null	Token ID of the opposite outcome for the same condition
`complement_token_label`	string \| null	Label of the opposite outcome (e.g. “No”, “Under”, “Down”)
`is_neg_risk`	boolean \| null	`true` for neg-risk markets, `false` for standard CTF markets

All fields are additive and nullable (null when condition metadata is unavailable) - existing clients are unaffected. Only order_filled events are changed; fee_refund, activity, and lifecycle events are unchanged.

February 18, 2026

List Markets: Token ID Filter

The GET /v2/polymarket/markets endpoint now supports a token_id query parameter. Pass one or more token IDs (up to 50) to look up markets by either side’s token ID.

Crypto Up/Down: 5-Minute Timeframe

The GET /v2/polymarket/crypto-updown endpoint now supports 5m as a timeframe filter, in addition to the existing 15m, 1h, 4h, and daily options.

February 17, 2026

New Endpoint

Category	Endpoint	Description
Wallets	`GET /v2/polymarket/wallets/profiles`	Batch wallet profiles - fetch up to 20 wallet profiles in a single request

Pass a comma-separated list of addresses via the addresses query parameter. Returns the same WalletProfileResponse data as the single wallet endpoint. Wallets not found are omitted from the response.

February 10, 2026

Total PnL & Rolling Window Metrics

Total PnL (realized + unrealized - net fees) is now available across all analytics, leaderboard, smart money, and wallet endpoints. Filter, sort, and view total PnL alongside realized PnL for a complete picture of wallet performance.

Rolling total PnL accuracy timeline - Rolling windows need time to accumulate full data:

All-time total PnL: accurate immediately (February 10, 2026)
1-day rolling total PnL: fully accurate starting February 11, 2026
7-day rolling total PnL: fully accurate starting February 17, 2026
30-day rolling total PnL: fully accurate starting March 12, 2026

New Filter Parameters

Endpoint	New Parameters
`GET /v2/polymarket/leaderboard`	`min_total_pnl`, `max_total_pnl`, `max_volume`, `max_trades`, `max_roi`, `max_profit_factor`, `max_win_rate`, `max_avg_trade_usd`, `max_wallet_age_days`
`GET /v2/polymarket/leaderboard/market/{condition_id}`	`min_total_pnl`, `max_total_pnl`, `max_trades`, `max_volume`
`GET /v2/polymarket/wallets/filter`	`min_total_pnl`, `max_total_pnl`
`GET /v2/polymarket/markets/smart-activity`	`min_total_pnl`
`GET /v2/polymarket/market/{condition_id}/smart-money`	`min_total_pnl`

Schema Changes

Endpoint / Schema	Change
`WindowMetrics`	Added `total_pnl` field (realized + unrealized - net fees)
`LeaderboardEntry`	Added `total_pnl` field and `first_trade_at` field; `total_pnl` now available as a sort option
`SmartActivityMarket`	Added `smart_total_pnl` field; `smart_total_pnl` now available as a sort option
`SmartMoneyPositioning`	Added `total_smart_total_pnl` field
`GET /v2/polymarket/positions`	Default sort order changed from `desc` to `asc`

February 8, 2026

New Endpoints

Category	Endpoint	Description
Polymarket	`GET /v2/polymarket/positions`	Bulk position fetching with block/timestamp filtering and cursor pagination for backfill and streaming
Wallets	`GET /v2/polymarket/wallet/volume-chart/{wallet}`	Per-wallet volume chart with BUY/SELL breakdown by period
Analytics	`GET /v2/polymarket/market/{condition_id}/top-holders`	Top holders for a market ranked by position size

Schema Changes

Endpoint / Schema	Change
`GET /v2/polymarket/markets/smart-activity`	`min_realized_pnl` threshold increased from $1,000 to$ 5,000
`GET /v2/binance/candles/{symbol}`	`start_time` and `end_time` are now optional (were required)
`PositionDetails`	Added `total_shares_bought` field (total shares ever purchased, preserved after redemption); `shares` now described as current holdings (0 for closed positions)
`WalletProfileResponse`	Added `total_pnl` (realized + unrealized - net fees) and `unrealized_pnl` fields

February 4, 2026

API v2 Launch

We’re introducing API v2 - a major update with 14 new endpoints, improved pagination, and expanded analytics capabilities. v1 remains fully supported; switch between versions using the dropdown in the docs sidebar. Base path: All v2 endpoints live under /v2/ (e.g., https://api.predexon.com/v2/polymarket/markets).

New Endpoints

Binance Data

Real-time and historical Binance book ticker data for backtesting crypto up/down markets.

Smart Money Analytics

Track where profitable wallets are trading, filter by PnL/win rate, and discover alpha.

Wallet Intelligence

Full wallet profiles, trading style classification, market exposure, and similar wallet discovery.

Enhanced Market Data

Events grouping, crypto up/down markets, and per-period volume charts.

Category	Endpoint	Description
Binance	`GET /v2/binance/ticks/{symbol}`	Raw book ticker data at microsecond granularity
Binance	`GET /v2/binance/candles/{symbol}`	OHLCV candles derived from book ticker mid-prices (1s to 1d intervals)
Smart Money	`GET /v2/polymarket/markets/smart-activity`	Markets ranked by smart wallet activity
Smart Money	`GET /v2/polymarket/market/{condition_id}/smart-money`	Smart money positioning for a specific market
Analytics	`GET /v2/polymarket/leaderboard`	Global wallet leaderboard with 22 filter/sort parameters
Analytics	`GET /v2/polymarket/leaderboard/market/{condition_id}`	Per-market leaderboard
Analytics	`GET /v2/polymarket/cohorts/stats`	Aggregate stats for wallet cohorts
Analytics	`GET /v2/polymarket/wallets/filter`	Filter wallets by market participation and performance
Wallets	`GET /v2/polymarket/wallet/{wallet}`	Full wallet profile with metrics across all time windows
Wallets	`GET /v2/polymarket/wallet/{wallet}/markets`	Markets a wallet has traded
Wallets	`GET /v2/polymarket/wallet/{wallet}/similar`	Find wallets with similar trading patterns
Markets	`GET /v2/polymarket/events`	List events with grouped markets
Markets	`GET /v2/polymarket/crypto-updown`	Crypto up/down prediction markets
Markets	`GET /v2/polymarket/volume-chart/{condition_id}`	Per-period volume breakdown for a market

WebSocket Updates

WebSocket API

Major improvements to the WebSocket API with new event types, refined plan tiers, and better connection management.

New: Fee refund events The trades channel (orders) now delivers two event types: order_filled and fee_refund. Fee refund events allow precise net fee calculations by tracking Polymarket’s maker rebate program. Correlate refunds to trades via order_hash. Plan tiers restructured (Free/Pro/Desk → Free/Dev/Pro/Enterprise)

Limit	Free	Dev	Pro	Enterprise
WebSocket access	No	Yes	Yes	Yes
Subscriptions per connection	-	10	100	Custom
Items per subscription	-	10	500	Custom
Total items	-	100	50,000	Custom
Wildcard	-	No	2 per channel	Yes
Priority routing	-	No	No	Yes

Wildcard rules updated

Wildcard connections are now tracked per-channel (e.g. a wildcard on orders does not count against activity)
A wildcard connection cannot mix wildcard and regular subscriptions on the same channel
Pro plan allows 2 wildcard connections per channel

Filter restrictions by channel

market_slugs filter is now only available on the trades (orders) channel
users filter is not available on the lifecycle channel
All channels support condition_ids and wildcard ["*"]

New error code: RATE_LIMIT - returned when a client is sending messages too fast Keepalive documentation: Server pings every 30s, 60s pong timeout, 2-minute idle timeout for zero subscriptions, and buffer overflow protections (1 MB drop threshold, 4 MB disconnect)

Breaking Changes (v1 → v2)

These changes only affect v2 endpoints. v1 endpoints remain unchanged.

Path parameter renamed: {wallet_address} → {wallet} All wallet-related endpoints now use {wallet} instead of {wallet_address}:

/v2/polymarket/wallet/pnl/{wallet}
/v2/polymarket/wallet/positions/{wallet}
/v2/dflow/wallet/pnl/{wallet}
/v2/dflow/wallet/positions/{wallet}

Pagination: offset → cursor-based Several endpoints have switched from offset pagination to cursor-based pagination_key for better performance on large datasets:

Endpoint	Removed	Added
`/v2/polymarket/trades`	`offset`	`pagination_key`
`/v2/dflow/trades`	`offset`	`pagination_key`
`/v2/kalshi/markets`	`offset`	`pagination_key`
`/v2/kalshi/trades`	`offset`	`pagination_key`

Parameter renames:

Endpoint	v1 Param	v2 Param
`/v2/polymarket/trades`	`user`	`wallet`
`/v2/polymarket/activity`	`user`	`wallet`

Removed parameters:

Endpoint	Removed Param	Notes
`/v2/polymarket/markets`	`token_id`	Use `condition_id` instead
`/v2/matching-markets/pairs`	`match_type`	All pairs are exact matches (similarity ≥ 95)

New Filter Parameters

Endpoint	New Parameters
`/v2/polymarket/markets`	`min_volume_1d`, `min_volume_7d`, `min_volume_30d`, `min_trades_1d`, `min_trades_7d`, `min_trades_30d`
`/v2/polymarket/trades`	`min_total`, `wallet`
`/v2/polymarket/activity`	`sort_by`, `wallet`

January 2026

January 19, 2026

Schema Updates

Endpoint	Change
`/v1/matching-markets`	Added `polymarket_condition_id` and `polymarket_market_id` query parameters
`/v1/matching-markets`	Added `match_type` query parameter to filter by `exact`, `related`, or `all`
`/v1/matching-markets`	Response now includes `condition_id` and `market_id` fields for Polymarket markets
`/v1/matching-markets/pairs`	Response now includes `condition_id` and `market_id` fields for Polymarket markets
`/v1/matching-markets/pairs`	Response now includes `match_type` field for each pair

January 16, 2026

New Features

Trading API

Added support for trading on Polymarket and Kalshi prediction markets:

POST /api/users/{userId}/orders - Place buy or sell orders
GET /api/users/{userId}/positions - Get current positions with PnL
GET /api/users/{userId}/balance - Get available balances
POST /api/users/{userId}/redeem - Redeem resolved positions

January 15, 2026

Schema Updates

Endpoint	Change
`/v1/kalshi/markets`	Added `yes_subtitle` and `no_subtitle` fields (replaces single `subtitle` field)
`/v1/dflow/wallet/positions/{wallet_address}`	Added `yes_subtitle`, `no_subtitle`, `market_title`, `outcome`, `status`, `total_cost_basis`, `total_qty_bought`, `total_qty_sold`, `first_trade_at`, `last_trade_at` fields

January 13, 2026

New Features

Dflow Support

Added support for Dflow prediction market platform with three new endpoints:

GET /v1/dflow/trades - Fetch trade history for a wallet
GET /v1/dflow/wallet/positions/{wallet_address} - Get current positions with cost basis and PnL
GET /v1/dflow/wallet/pnl/{wallet_address} - Get realized PnL history

Breaking Changes

Candlesticks Response Structure ChangedThe /v1/polymarket/candlesticks/{condition_id} endpoint response structure has been updated:Before: Nested array of [candlestick_data_array, token_metadata] tuples After: Flat structure with condition_id at root and candlesticks as a direct array of candlestick objects

// New response structure
{
  "condition_id": "0x1234...",
  "candlesticks": [
    {
      "end_period_ts": 1704070800,
      "price": { "open": 0.55, "high": 0.57, ... },
      "volume": 125000.50,
      "trades_count": 847
    }
  ]
}

Schema Updates

Change	Details
CandlestickData	New properly typed schema replacing untyped tuple format
CandlesticksResponse	Added `condition_id` field, flattened candlesticks array
PriceData	New schema with explicit dollar-formatted string fields (`open_dollars`, `high_dollars`, `low_dollars`, `close_dollars`, `mean_dollars`, `previous_dollars`)

Improvements

All price values in candlesticks now include both numeric and dollar-formatted string representations
Response schemas are now fully typed for better client SDK generation
Improved API documentation with accurate response examples

How to Stay Updated

Discord

Join our Discord for real-time updates and community support

All breaking changes are announced at least 3 days in advance via Discord.

​March 2026

​March 15, 2026

​New Endpoints

​Kalshi Orderbook Data Gap

​March 7, 2026

​WebSocket: Pending Trades Channel

​February 2026

​February 20, 2026

​WebSocket: Trade Event Payload Update

​February 18, 2026

​List Markets: Token ID Filter

​Crypto Up/Down: 5-Minute Timeframe

​February 17, 2026

​New Endpoint

​February 10, 2026

​Total PnL & Rolling Window Metrics

​New Filter Parameters

​Schema Changes

​February 8, 2026

​New Endpoints

​Schema Changes

​February 4, 2026

​API v2 Launch

New Endpoints

Binance Data

Smart Money Analytics

Wallet Intelligence

Enhanced Market Data

WebSocket Updates

WebSocket API

Breaking Changes (v1 → v2)

New Filter Parameters

​January 2026

​January 19, 2026

​Schema Updates

​January 16, 2026

​New Features

Trading API

​January 15, 2026

​Schema Updates

​January 13, 2026

​New Features

Dflow Support

​Breaking Changes

​Schema Updates

​Improvements

​How to Stay Updated

Discord

March 2026

March 15, 2026

New Endpoints

Kalshi Orderbook Data Gap

March 7, 2026

WebSocket: Pending Trades Channel

February 2026

February 20, 2026

WebSocket: Trade Event Payload Update

February 18, 2026

List Markets: Token ID Filter

Crypto Up/Down: 5-Minute Timeframe

February 17, 2026

New Endpoint

February 10, 2026

Total PnL & Rolling Window Metrics

New Filter Parameters

Schema Changes

February 8, 2026

New Endpoints

Schema Changes

February 4, 2026

API v2 Launch

January 2026

January 19, 2026

Schema Updates

January 16, 2026

New Features

January 15, 2026

Schema Updates

January 13, 2026

New Features

Breaking Changes

Schema Updates

Improvements

How to Stay Updated