Changelog

April 30, 2026

NewImprovement

WebSocket: Crypto Prices Channel

New Channel: crypto_prices (Chainlink Data Streams)

Real-time crypto price ticks relayed from Chainlink Data Streams. Subscribe with platform: "chainlink", type: "crypto" and a feeds filter — wildcard supported. See Crypto Prices.

Supported feeds: BTC/USD, ETH/USD, SOL/USD, XRP/USD, BNB/USD, DOGE/USD, HYPE/USD.

{
  "action": "subscribe",
  "platform": "chainlink",
  "version": 1,
  "type": "crypto",
  "filters": { "feeds": ["BTC/USD", "ETH/USD"] }
}

Each tick is a price_feed event with price, bid, ask, and observed_at (Unix seconds). One event per upstream observation — no batching. Plan limits and wildcard rules are the same as the existing channels.

WebSocket: Explicit `role` on order_filled

Every order_filled event on the trades channel now carries a role field — "maker" or "taker" — telling you which OrderFilled emission you’re looking at:

role: "maker" — per-maker fill (one per maker matched in the tx). taker is the real taker user address. This is what you want by default.
role: "taker" — synthetic taker-aggregate emission (one per matchOrders tx, summing across all makers). taker equals the exchange contract address.

Don’t sum volume across both roles — the taker-aggregate row covers the same shares as the per-maker rows. Filter on role === "maker" for maker-attribution counts, or role === "taker" for one-row-per-taker-action dashboards. Previously consumers had to derive this implicitly by checking taker against the five exchange contract addresses; now it’s a first-class field.

The field is fully additive — existing clients ignore it unchanged.

April 30, 2026

NewImprovement

Connected Wallets Endpoint

New Endpoint: GET /v2/polymarket/wallet/{address}/cluster

Discover sibling wallets behind a seed address via the on-chain transfer graph (USDC, pUSD, CTF) plus identity-proof signals — shared signer, shared X username, shared first funder. Each sibling carries a confidence score (0–100); the default min_confidence=70 returns strong-evidence links only.

Use this to surface likely-related accounts behind a single operator — alt wallets, hot/cold splits, multi-account farming patterns. Results are cached; pass recompute=true to force a fresh BFS. Requires Dev or Pro tier.

Trades: V2 Exchange Fields

Every row in the /v2/polymarket/trades response now carries Polymarket exchange version metadata:

exchange_version — 1 (V1 CTF/NegRiskCTF) or 2 (V2).
builder — V2 builder attribution tag (bytes32 hex). Empty for V1 fills or V2 fills with no builder.
metadata — V2 opaque metadata tag (bytes32 hex). Empty for V1 fills or V2 fills with no metadata.

The endpoint also accepts a new builder query parameter to filter fills attributed to a specific builder tag.

April 25, 2026

NewImprovement

Cross-Platform Matching: Limitless Support

Find Matching Markets and Get Matched Pairs now cover Limitless alongside Polymarket and Kalshi.Changes:

/v2/matching-markets: new limitless_slug query param — pass a Limitless slug to find equivalent markets on Polymarket or Kalshi.
/v2/matching-markets/pairs: new venue filter — restrict results to a specific venue pairing.
MatchedPair schema: kalshi block is now optional, and a new optional limitless block (using LimitlessPairInfo) is included when a Limitless equivalent exists.

Existing clients reading pair.kalshi directly should null-check before access — pairs without a Kalshi equivalent will omit the field.

April 24, 2026

NewImprovement

Per-Token Candlesticks

New Endpoint: GET /v2/polymarket/candlesticks/token/{token_id}

Fetch raw OHLCV candles for a single outcome token. Unlike the condition-level endpoint, prices are not normalized — NO-token prices stay as NO prices, and volume reflects only that token’s trades.

Use this when you need to chart each side of a binary market separately, or when you only have a token ID. Same intervals, same auto mode, same response shape — the response now also includes a top-level token_id (and condition_id becomes optional, set only on the condition-level endpoint).

Activity: `CONVERT` Events + NegRisk Fields

The activity endpoint now returns CONVERT events alongside SPLIT, MERGE, and REDEEM — these are NegRisk position conversions (sell NO on a subset of conditions, buy YES on the remainder).New fields on the Activity schema:

neg_risk_market_id — NegRisk parent market identifier (32-byte hex, matches Gamma’s Event.negRiskMarketID). Populated only on CONVERT rows.
index_set — NegRisk indexSet bitmask (decimal string) of which outcomes were involved. Populated only on CONVERT rows.
market_id is now nullable — it’s null on CONVERT rows.

On CONVERT rows, condition_id is an empty string and market_id is null — filtering by either will not match conversion rows. Use neg_risk_market_id instead. Conversions are a market-level operation, not a per-outcome one.

April 21, 2026

NewImprovement

WebSocket: Conversion Events & Pending Trade Gating

New conversion event type on the activity channelV2 NegRisk “No” position conversions are now streamed as a new conversion event on the activity channel. Includes neg_risk_event_id (NegRiskAdapter marketId) and index_set (uint256 bitmap of converted question indices). See Activity Events.

Two things to be aware of — neither affects most clients:

ActivityAlert.condition_id is null only for the new conversion event type. Clients with strict typed generators (condition_id: string) should widen to string | null if they want to consume conversion events. Clients that filter by event_type in {"split", "merge", "redeem"} are unaffected.
Pending trade events (filters.status: "all" or "pending") are now gated to Dev+ plans. Free-tier clients that don’t request pending (default "confirmed") continue to work unchanged.

April 20, 2026

Improvement

WebSocket: Token IDs on `condition_prepared`

The condition_prepared lifecycle event now includes derived token IDs for binary markets (outcome_slot_count === 2) in the tokens array. Previously clients had to query Gamma or CLOB after receiving the event — now token IDs are available immediately from the WebSocket payload.

Binary markets: tokens: [{ token_id, label: "Yes" }, { token_id, label: "No" }] — derived from condition_id + is_neg_risk using the CTF Gnosis formula.
Non-binary markets: tokens: null (unchanged).
Labels are placeholders — resolve canonical outcome labels from Gamma/CLOB if needed.

April 19, 2026

NewImprovement

WebSocket: Polymarket V2 Support

The WebSocket service now handles Polymarket V2 contracts alongside V1. Fully backwards-compatible — existing clients require zero code changes. See the V2 Migration Guide for details.Additive changes:

New version field (1 or 2) on trade, activity, and lifecycle events
New builder and metadata fields on V2 order_filled events
New collateral channel for pUSD deposit/withdrawal events (polyusd_wrapped / polyusd_unwrapped)
New condition_prepared event type on the lifecycle channel (covers V1 + V2 market creation)

Breaking for token discovery: V2 exchanges no longer emit TokenRegistered. Clients using token_registered as a “new market” signal should switch to condition_prepared to cover both V1 and V2 markets.

April 12, 2026

Improvement

Candlesticks: New Intervals & Auto Mode

The candlestick endpoint now supports 5-minute and 15-minute intervals, plus an auto mode (interval=0) that picks the best interval based on your time range. Auto is now the default.The response also includes first_trade_ts and last_trade_ts fields — the timestamps of the first and last trades in the market.

Interval	Value	Max Range
Auto	`0` (default)	Best fit for your range
1m	`1`	7 days
5m	`5`	7 days
15m	`15`	30 days
1h	`60`	30 days
1d	`1440`	Unlimited (all-time)

April 7, 2026

Improvement

Universal Predexon IDs on All List Market Endpoints

predexon_id is now included in outcome objects across all five list market endpoints: Polymarket, Kalshi, Opinion, Limitless, and Predict.Fun. All five endpoints also support a predexon_id query parameter to filter markets by outcome ID.A Predexon ID is a stable, deterministic identifier for each tradeable outcome (px- followed by a 12-character base32 hash), consistent across all venues.

April 6, 2026

NewDeprecatedImprovement

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

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

The 1d 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)

April 4, 2026

New

WebSocket: Oracle Channel

New Channel: oracle

Real-time UMA oracle resolution events for Polymarket markets — proposals, settlements, disputes, and resets.

Subscribe by condition_ids or market_slugs. Wildcard (["*"]) supported.
Event types: proposal, settled, dispute, reset.
Enrichment fields: title, market_slug, image, outcomes, tokens, is_neg_risk.

April 3, 2026

New

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, or market_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.

March 28, 2026

New

New Endpoints: Opinion, Limitless, Predict.Fun Markets

Opinion

List Opinion markets with filtering, sorting, and event grouping.

Limitless

List Limitless markets with filtering, sorting, and trade type filter.

Predict.Fun

List Predict.Fun markets with filtering, sorting, and event grouping.

All three support status filtering, text search, cursor pagination, and platform-specific filters.

March 23, 2026

Improvement

Smart Activity: Market Status Filter

GET /v2/polymarket/markets/smart-activity now supports an optional status query parameter.

Value	Description
`open`	Currently tradable markets only
`closed`	Resolved/settled markets only
(omitted)	All markets (default)

March 15, 2026

New

New Endpoints: Cross-Platform Orderbooks

Limitless

Historical orderbook snapshots for Limitless.

Opinion

Historical orderbook snapshots for Opinion.

Predict.Fun

Historical orderbook snapshots for Predict.Fun.

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

Kalshi data gap: Orderbook data unavailable between March 12 08:00 UTC and March 14 18:10 UTC due to an upstream API format change.

March 7, 2026

New

WebSocket: Pending Trades Channel

New Channel: pending-trades

Detect trade events from the Polygon mempool 3–5 seconds before on-chain confirmation.

February 20, 2026

Improvement

WebSocket: New Trade Event Fields

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 (No/Under/Down)
`complement_token_id`	string \| null	Token ID of the opposite outcome
`complement_token_label`	string \| null	Label of the opposite outcome
`is_neg_risk`	boolean \| null	`true` for neg-risk markets

All fields are additive and nullable — existing clients are unaffected.

February 18, 2026

Improvement

List Markets: Token ID Filter

GET /v2/polymarket/markets now supports a token_id query parameter (up to 50 IDs).

Crypto Up/Down: 5-Minute Timeframe

GET /v2/polymarket/crypto-updown now supports 5m as a timeframe filter.

February 17, 2026

New

New Endpoint: Batch Wallet Profiles

Batch Wallet Profiles

GET /v2/polymarket/wallets/profiles — fetch up to 20 wallet profiles in a single request via comma-separated addresses.

February 10, 2026

NewImprovement

Total PnL & Rolling Window Metrics

Total PnL

Total PnL (realized + unrealized - net fees) is now available across all analytics, leaderboard, smart money, and wallet endpoints.

Rolling total PnL accuracy timeline:

All-time: accurate immediately (February 10, 2026)
1-day rolling: fully accurate February 11, 2026
7-day rolling: fully accurate February 17, 2026
30-day rolling: fully accurate 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

Schema	Change
`WindowMetrics`	Added `total_pnl` field
`LeaderboardEntry`	Added `total_pnl` and `first_trade_at`; `total_pnl` available as sort option
`SmartActivityMarket`	Added `smart_total_pnl`; available as sort option
`SmartMoneyPositioning`	Added `total_smart_total_pnl`
`GET /v2/polymarket/positions`	Default sort changed from `desc` to `asc`

February 8, 2026

New

New Endpoints

Bulk Positions

Bulk position fetching with block/timestamp filtering and cursor pagination.

Wallet Volume Chart

Per-wallet volume chart with BUY/SELL breakdown by period.

Top Holders

Top holders for a market ranked by position size.

Schema changes

Schema	Change
`GET /v2/polymarket/markets/smart-activity`	`min_realized_pnl` threshold increased $1K →$ 5K
`GET /v2/binance/candles/{symbol}`	`start_time` and `end_time` now optional
`PositionDetails`	Added `total_shares_bought` field
`WalletProfileResponse`	Added `total_pnl` and `unrealized_pnl` fields

February 4, 2026

NewBreaking Change

API v2 Launch

API v2

14 new endpoints, improved pagination, and expanded analytics. v1 remains fully supported.

Base path: /v2/ (e.g., https://api.predexon.com/v2/polymarket/markets)

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.

All new endpoints

Category	Endpoint	Description
Binance	`GET /v2/binance/ticks/{symbol}`	Raw book ticker data at microsecond granularity
Binance	`GET /v2/binance/candles/{symbol}`	OHLCV candles from book ticker mid-prices (1s–1d)
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 market
Analytics	`GET /v2/polymarket/leaderboard`	Global wallet leaderboard (22 filter/sort params)
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 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

WebSocket updates

Fee refund events — the trades channel now delivers order_filled and fee_refund event types. 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 / connection	-	10	100	Custom
Items / subscription	-	10	500	Custom
Total items	-	100	50,000	Custom
Wildcard	-	No	2 / channel	Yes
Priority routing	-	No	No	Yes

Wildcard rules: tracked per-channel, cannot mix wildcard and regular subs on same channel, Pro allows 2 wildcard connections per channel.Filter restrictions: market_slugs only on trades channel, users not on lifecycle channel. All channels support condition_ids and ["*"].New error code: RATE_LIMIT. Keepalive: 30s ping, 60s pong timeout, 2min idle timeout, 1MB drop / 4MB disconnect buffer limits.

Breaking changes (v1 → v2)

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

Path parameter renamed: {wallet_address} → {wallet} on all wallet endpoints.Pagination: switched from offset to cursor-based pagination_key:

Endpoint	Change
`/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: user → wallet on /v2/polymarket/trades and /v2/polymarket/activity.Removed parameters: token_id from /v2/polymarket/markets (use condition_id), match_type from /v2/matching-markets/pairs.

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 19, 2026

Improvement

Matching Markets: Enhanced Filtering

New query parameters and response fields for cross-platform market matching.

Change	Details
New query params	`polymarket_condition_id`, `polymarket_market_id`, `match_type` (`exact`, `related`, `all`)
New response fields	`condition_id`, `market_id` for Polymarket markets
Pairs endpoint	Now includes `match_type` field per pair

January 16, 2026

New

Trading API

Place orders, view positions, check balances, and redeem resolved positions on Polymarket and Kalshi.

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

Improvement

Schema Updates

Endpoint	Change
`/v1/kalshi/markets`	Added `yes_subtitle` and `no_subtitle` fields
`/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`

January 13, 2026

NewBreaking Change

Dflow Support

New Platform: Dflow

Three new endpoints for the Dflow prediction market platform.

GET /v1/dflow/trades — Trade history for a wallet
GET /v1/dflow/wallet/positions/{wallet_address} — Positions with cost basis and PnL
GET /v1/dflow/wallet/pnl/{wallet_address} — Realized PnL history

Breaking Change: Candlesticks Response

The /v1/polymarket/candlesticks/{condition_id} response structure changed from nested [data, metadata] tuples to a flat structure:

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

Schema updates: CandlestickData now fully typed, CandlesticksResponse has condition_id field, new PriceData schema with dollar-formatted strings.

Documentation Index

​WebSocket: Crypto Prices Channel

New Channel: crypto_prices (Chainlink Data Streams)

​WebSocket: Explicit role on order_filled

​Connected Wallets Endpoint

New Endpoint: GET /v2/polymarket/wallet/{address}/cluster

​Trades: V2 Exchange Fields

​Cross-Platform Matching: Limitless Support

​Per-Token Candlesticks

New Endpoint: GET /v2/polymarket/candlesticks/token/{token_id}

​Activity: CONVERT Events + NegRisk Fields

​WebSocket: Conversion Events & Pending Trade Gating

​WebSocket: Token IDs on condition_prepared

​WebSocket: Polymarket V2 Support

​Candlesticks: New Intervals & Auto Mode

​Universal Predexon IDs on All List Market Endpoints

​Wallet Positions: Per-Position Net Fees

New Field: net_fees_usd

​fees_refunded Deprecated

​Candlesticks: All-Time Range for Daily Interval

​WebSocket: Oracle Channel

New Channel: oracle

​WebSocket: Orderbook Channel

New Channel: orderbook

​New Endpoints: Opinion, Limitless, Predict.Fun Markets

Opinion

Limitless

Predict.Fun

​Smart Activity: Market Status Filter

​New Endpoints: Cross-Platform Orderbooks

Limitless

Opinion

Predict.Fun

​WebSocket: Pending Trades Channel

New Channel: pending-trades

​WebSocket: New Trade Event Fields

​List Markets: Token ID Filter

​Crypto Up/Down: 5-Minute Timeframe

​New Endpoint: Batch Wallet Profiles

Batch Wallet Profiles

​Total PnL & Rolling Window Metrics

Total PnL

​New Endpoints

Bulk Positions

Wallet Volume Chart

Top Holders

​API v2 Launch

API v2

Binance Data

Smart Money Analytics

Wallet Intelligence

Enhanced Market Data

​Matching Markets: Enhanced Filtering

​Trading API

Trading API

​Schema Updates

​Dflow Support

New Platform: Dflow

​Breaking Change: Candlesticks Response

WebSocket: Crypto Prices Channel

WebSocket: Explicit `role` on order_filled

Connected Wallets Endpoint

Trades: V2 Exchange Fields

Cross-Platform Matching: Limitless Support

Per-Token Candlesticks

Activity: `CONVERT` Events + NegRisk Fields

WebSocket: Conversion Events & Pending Trade Gating

WebSocket: Token IDs on `condition_prepared`

WebSocket: Polymarket V2 Support

Candlesticks: New Intervals & Auto Mode

Universal Predexon IDs on All List Market Endpoints

Wallet Positions: Per-Position Net Fees

`fees_refunded` Deprecated

Candlesticks: All-Time Range for Daily Interval

WebSocket: Oracle Channel

WebSocket: Orderbook Channel

New Endpoints: Opinion, Limitless, Predict.Fun Markets

Smart Activity: Market Status Filter

New Endpoints: Cross-Platform Orderbooks

WebSocket: Pending Trades Channel

WebSocket: New Trade Event Fields

List Markets: Token ID Filter

Crypto Up/Down: 5-Minute Timeframe

New Endpoint: Batch Wallet Profiles

Total PnL & Rolling Window Metrics

New Endpoints

API v2 Launch

Matching Markets: Enhanced Filtering

Trading API

Schema Updates

Dflow Support

Breaking Change: Candlesticks Response