Changelog - Predexon API

Removed

Market-matching endpoints removed

The cross-venue market-matching endpoints, deprecated on July 14, have been sunset and now return 410 Gone:

GET /v2/matching-markets
GET /v2/matching-markets/pairs
GET /v2/markets
GET /v2/markets/listings
GET /v2/outcomes/{predexon_id}

Sports live-state updates have also concluded with the end of the FIFA World Cup: the sports_live and sports_fifa_world_cup WebSocket channels no longer emit events, and /v2/sports/fifa-world-cup/live-games continues to serve final game states.All venue-specific data endpoints, discovery, analytics, tick history, and the WebSocket service are unaffected. Questions? team@predexon.com.

New

Sub-cent Kalshi orderbook history

New endpoint: GET /v2/kalshi/orderbooks-subcent. Kalshi prices markets in sub-cent increments, and this endpoint reflects those prices exactly: decimal price levels, spreads as tight as they really are, fractional contract sizes, plus per-snapshot source provenance and a sources filter. History from January 8th, 2026. Free and unlimited like the legacy endpoint.The legacy integer-cent GET /v2/kalshi/orderbooks will be deprecated soon. It rounds prices to whole cents, which widens spreads and merges neighboring price levels. Switch to the sub-cent endpoint now; the deprecation date will be announced here. The legacy limit cap was also raised to 2000 (docs previously said 200).

Deprecated

Market-matching endpoints deprecated

The cross-venue market-matching endpoints are deprecated as of July 14, 2026 and scheduled for sunset:

GET /v2/matching-markets
GET /v2/matching-markets/pairs
GET /v2/markets
GET /v2/markets/listings
GET /v2/outcomes/{predexon_id}

The endpoints remain available during a transition window. GET /v2/markets/search (cross-venue text search) is not affected, and all venue-specific data endpoints, sports endpoints, and the WebSocket service continue unchanged.If your integration depends on the deprecated endpoints, please contact us to discuss alternatives.

Removed

Trading disabled — withdrawal-only mode in effect

As announced, the Trading API is now withdrawal-only. Order placement (POST /api/accounts/{accountId}/orders) returns 403 trading_disabled on every venue. Cancel, redeem, balance, positions, transfers, and withdrawals keep working.

July 17, 2026 — final withdrawal deadline. Cancel open orders, redeem resolved positions, and withdraw all funds by this date.

These dates supersede the June 25 / June 29 dates in the June 21 entry below — the wind-down timeline was extended to July 10 / July 17.Questions, or need help withdrawing? Reach out at team@predexon.com.

New

Trades: multi-wallet filtering and hash lookups

Two additions to GET /v2/polymarket/trades. No breaking changes: all existing requests, response shapes, and pagination cursors are unaffected.

Multi-wallet filtering

The wallet parameter now accepts a comma-separated list of up to 50 addresses (previously one):

GET /v2/polymarket/trades?wallet=0xabc...,0xdef...,0x123...&limit=100

Returns one merged feed of all listed wallets’ trades, time-ordered (newest first by default), with standard cursor pagination — designed for tracking a list of followed wallets.
Address order doesn’t matter and duplicates are ignored; the same list in any order returns identical results and pagination keys.
Trades match on the maker side, same as the existing single-wallet filter.
Combines with all existing parameters (market_slug / condition_id / token_id, start_time / end_time, min_total, order, pagination_key).
Errors: more than 50 addresses returns 400; any invalid address returns 400 identifying which one.
Fully backward compatible: single-address requests behave exactly as before, and existing pagination keys remain valid.

Order hash and transaction hash filters

Two new optional parameters (each 0x + 64 hex chars):

Parameter	Returns
`tx_hash`	all fills executed in that transaction
`order_hash`	all fills of that order (an order can fill across multiple transactions)

GET /v2/polymarket/trades?tx_hash=0x52e2...42e8
GET /v2/polymarket/trades?order_hash=0xdd14...33b1

Usable standalone (full-history point lookup, back to October 2022) or combined with each other and with any wallet/market/time filters.
Invalid hash format returns 400.

NewDeprecated

Exact lifetime buy totals: `total_bought_usd`

Position responses now include a new field, total_bought_usd: the exact total USD ever spent buying a position, cumulative over its lifetime and preserved even after redemption. It is computed from on-chain fills and verified against them.Available on both position endpoints:

Endpoint	Docs
`GET /v2/polymarket/wallet/positions/{wallet}`	Wallet Positions
`GET /v2/polymarket/positions`	Positions

`total_shares_bought` is deprecated

Use total_bought_usd instead. The share-count derivation behind total_shares_bought is approximate for positions that were fully closed and later reopened at a different price, which can make it diverge significantly from the true buy total. The field is not being removed and its values are unchanged — existing clients see one extra JSON key and nothing else changes.

Orderbook snapshot limit raised

GET /v2/polymarket/orderbooks and GET /v2/kalshi/orderbooks now accept limit up to 2000 (previously 200). The default remains 100.

DeprecatedRemoved

Trading API is being retired

The custodial Trading API (Unified Execution Infra) is winding down. The read-only Data & Signals API is unaffected.

June 25, 2026 — trading stops. Sell or close any open positions before this date. After it, the Trading API is withdrawal-only (cancel, redeem, withdraw).
June 29, 2026 — final withdrawal deadline. Redeem resolved positions and withdraw all funds by this date.

New account creation and API key issuance are already closed — POST /api/accounts/create returns 403.

Order Router removed

The Unified Order Router (/api/accounts/{accountId}/router/*) has been retired and its documentation removed. Until trading stops on June 25, place orders directly with venue-specific orders.Questions, or need help withdrawing? Reach out at team@predexon.com.

Removed

Dflow endpoints removed

The Dflow venue is deprecated. The three Data API endpoints below have been removed and now return 404. The corresponding MCP tools have been removed as well.

Endpoint	MCP tool
`GET /v2/dflow/trades`	`get_dflow_trades`
`GET /v2/dflow/wallet/positions/{wallet}`	`get_dflow_positions`
`GET /v2/dflow/wallet/pnl/{wallet}`	`get_dflow_pnl`

If you were depending on Dflow data, reach out at team@predexon.com so we can scope a replacement path.

NewChanged

New endpoints

Wallet Builder Fees

GET /v2/polymarket/builders/wallet/{wallet}. Total builder fees a wallet has paid over a rolling window or an exact start_time/end_time range, with a per-builder breakdown and optional builder_code filter. Each fill is scored at the rate in effect at the time it filled.

Position Top Holders

GET /v2/polymarket/position/{token_id}/top-holders. Largest holders of a single token (one outcome side), ranked by position size, with cursor pagination.

Polymarket Discovery & Taxonomy

Seven new endpoints for browsing and navigating Polymarket — categories, tags, series, and a unified search. These power navigation surfaces and autocomplete on top of the markets and events data.

Unified Search

GET /v2/polymarket/search. One query across markets, events, and tags, grouped by type.

Series

GET /v2/polymarket/series and GET /v2/polymarket/series/{slug}. Recurring market groupings (daily/weekly/monthly) plus a series’ events. The crypto up/down feature is just a named series.

Improvements

GET /v2/polymarket/events (keyset) gained optional include_markets (nest each event’s markets inline, capped by markets_per_event) plus min_open_interest and min_volume filters to return only liquid events. Events also now include an all-time trade count (trades_all_time).Per-tag and per-category open interest has been removed from the categories and tags endpoints — a tag/category-wide OI sum was unreliable. Rank by volume (total_volume_usd, rolling_metrics) and liquidity_usd instead. Both surfaces also gained trades_all_time.

Behavioral changes

A few request defaults and constraints changed. Set parameters explicitly if you were relying on the previous defaults.

Endpoint	Parameter	Before	Now
`GET /v2/markets`, `GET /v2/markets/listings`	`status`	no default (all statuses)	defaults to `open` — also accepts `closed`, `resolved`, `all`
`GET /v2/markets`, `GET /v2/markets/listings`	`limit`	default `20`	default `50` (max `200`)
`GET /v2/markets`, `GET /v2/markets/listings`	`search`	any length	must be 3–200 characters
`GET /v2/polymarket/wallet/positions/{wallet}`	`include_closed`	default `true`	default `false` — pass `include_closed=true` for closed/zero-balance positions

Pagination shape change on the Polymarket offset list endpoints. GET /v2/polymarket/markets and GET /v2/polymarket/events now return pagination: { has_more, limit, count, pagination_key } — the offset and total fields have been removed. Migrate to the cursor-based List Markets / List Events flow using pagination_key.

NewBeta

Canonical Markets API

Four new venue-agnostic endpoints exposing Predexon’s canonical outcome graph. These are the data layer the Order Router quotes against and the entry point for any cross-venue workflow.

List Canonical Markets

GET /v2/markets. Cross-venue canonical market containers with outcome-level predexon_ids.

Canonical Venue Listings

GET /v2/markets/listings. Flatten canonical markets into venue-native executable listings (token IDs, condition IDs, Kalshi tickers, market slugs).

Resolve a Canonical Outcome

GET /v2/outcomes/{predexon_id}. Resolve one canonical outcome ID to its full venue-equivalent listings.

Search Across Venues

GET /v2/markets/search. Keyword search returning interleaved results across Polymarket, Kalshi, Limitless, Opinion, and Predict.fun.

All four canonical endpoints are free and unlimited on every plan. Category and league filters supported. Cursor-based pagination.

Order Router

New: Route a single order across every venue

One canonical outcome, one order, every venue. The router quotes across Polymarket, Predict.fun, Opinion, Limitless, and Hyperliquid, splits the order fee-aware, and dispatches each leg to its matching venue.

Endpoints:

POST /api/accounts/{accountId}/router/quote. Pre-trade quote: project the best fill across every matched venue.
POST /api/accounts/{accountId}/router/orders. Place a routed order.
GET /api/accounts/{accountId}/router/orders. List routed orders.
GET /api/accounts/{accountId}/router/orders/{routerOrderId}. Get a routed order.
DELETE /api/accounts/{accountId}/router/orders/{routerOrderId}. Cancel a routed order.

The router uses Predexon’s canonical outcome graph to identify equivalent markets across venues. See the Order Router guide for the full flow.

Unified Transfers

New: One endpoint for every fund movement

POST /api/accounts/{accountId}/transfers replaces separate deposit and withdraw flows. One verb covers movement between the deposit wallet, venue trading wallets, and external addresses.

POST /api/accounts/{accountId}/transfers/quote. Project route and fees before committing.
POST /api/accounts/{accountId}/transfers. Execute the transfer.
GET /api/accounts/{accountId}/transfers. List transfers with status.
GET /api/accounts/{accountId}/transfers/{transferId}. Status of a single transfer.

Beta. Router and Transfers endpoints are marked beta. Existing per-venue order endpoints (POST /api/accounts/{accountId}/orders) continue to work unchanged.

Other improvements

$1 bridge minimum documented on Across-routed deposits.
Router 4xx errors moved from 502 to 400 in the OpenAPI spec to match shipped behavior.
Deposit-wallet behavior synced with deployed router.

Breaking ChangeImprovement

Connected Wallets: Async Compute + Larger Clusters

The Connected Wallets endpoint now returns either 200 or 202 depending on cache state - clients must handle both.

Behavior change. Hub-wallet clusters can take 60–180 seconds to compute, far beyond any HTTP timeout. On a cache miss, stale cache (>24h), or recompute=true, the endpoint now returns 202 Accepted with a Retry-After header and a {status, retry_after_seconds, reason, message} body. Background BFS runs out-of-band; the next call after Retry-After returns 200 from cache.

reason values on 202: miss, stale, forced, another_pod_computing (cross-pod Redis lock).Other changes:

limit upper bound bumped 200 → 1000. Up to 1000 siblings persisted per seed.
Cluster cache TTL is now 24 hours.
min_hops is now described as 1 = direct neighbor (previously 0 = direct).
Richer evidence documentation: hops, bidirectional, direct_flow, shared_peers, same_signer, same_x_username, shared_first_funder, is_verified_trader, class.

See the recommended client polling pattern in the docs.

NewImprovement

Polymarket V2 Builder Analytics

Four new endpoints exposing Polymarket V2 builder-attribution data - leaderboards, per-builder summaries, top markets per builder, and bucketed time-series.

Leaderboard

Ranked list of builders by attributed volume or fee revenue over 24h / 7d / 30d / all.

Builder Stats

Summary metrics for a single builder plus its full (taker_bps, maker_bps) rate history.

Builder Markets

Top markets attributed to a builder, ranked by volume.

Builder Timeseries

Bucketed (day or hour) volume and fee revenue for charting.

V2-only. V1 fills, the zero-sentinel builder, and reversed (sign != 1) rows are excluded. The leaderboard’s sort_by=fee is useful when looking at revenue-earning builders, since the highest-volume builders often charge 0 bps.

List Markets: `end_after` / `end_before` Filters

GET /v2/polymarket/markets now accepts two new optional Unix-timestamp (seconds) query parameters - end_after and end_before - to filter markets by end_time. Useful for listing markets that close in a specific window (e.g. “this week’s resolutions”).

NewImprovement

Cross-Platform Matching: Predict and Opinion Support

Find Matching Markets and Get Matched Pairs now include Predict.fun and Opinion canonical equivalents alongside Polymarket, Kalshi, and Limitless.Changes:

/v2/matching-markets: accepts Predict and Opinion identifiers (market_id, condition_id, or token_id) and returns exact canonical equivalents when available.
/v2/matching-markets/pairs: returns PREDICT and OPINION venue blocks by default when canonical equivalents exist.
venue filtering now supports polymarket, kalshi, limitless, predict, and opinion.

Predict.fun and Opinion matching is powered by the canonical matching graph. Existing Polymarket, Kalshi, and Limitless response fields remain backward-compatible.

NewPerformance

Polymarket Markets: Keyset Pagination

New Endpoint: GET /v2/polymarket/markets/keyset

List Polymarket markets with the same filters and sort options as /v2/polymarket/markets, but use cursor-based pagination_key instead of offset.

Use List Markets (Keyset Pagination) for large backfills and deep pagination. The existing offset endpoint remains unchanged.

Polymarket Events: Keyset Pagination

New Endpoint: GET /v2/polymarket/events/keyset

List Polymarket events with the same filters and sort options as /v2/polymarket/events, but use cursor-based pagination_key instead of offset.

Use List Events (Keyset Pagination) for large event crawls. The existing offset endpoint remains unchanged.

FixData Quality

Limitless: CLOB Open Interest

Limitless CLOB markets now return open_interest_usd: null instead of 0 because Limitless does not currently expose CLOB open interest through the indexed market API. AMM market open interest remains available.See Limitless Markets for the field note.

New

Trading API: Hyperliquid (HIP-4) Support

New Venue: Hyperliquid

Trade Hyperliquid HIP-4 prediction markets through the Predexon Trading API. Limit and market orders, full position lifecycle, and managed wallet provisioning - same shape as Polymarket, Predict, Opinion, and Limitless.

Trading

New venue: "hyperliquid" accepted on every /api/accounts/* endpoint (place order, cancel, positions, balance, redeem, withdraw, enable).
Markets are identified by assetId in the market bag - a single integer that pins down a specific HIP-4 outcome side. See Place Order for the per-venue identification table.
$10 minimum order notional (size × price ≥ 10) - applies to all orders. Smaller orders are rejected.
Market BUY takes size (not amount) - fills as many shares as possible at the best ask up to the requested quantity.

Funding

Bridge USDC to your Hyperliquid wallet via Across. Select Hyperliquid (HyperCore) as the destination chain. Funds arrive as USDH (HL’s USDC-pegged stablecoin) in your trading balance in ~1-2 minutes; /balance returns asset: "usdh".

Withdrawals

Deliver USDC on Arbitrum to any address. $10 minimum withdrawal. A $1 USDC fee is deducted before delivery - recipient receives amount - 1. Settlement takes ~3-4 minutes.

Available now for any API key. No allowlist - call POST /api/accounts/{accountId}/enable {"venue": "hyperliquid"} to provision a wallet.

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.

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.

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.

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.

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.

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.

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.

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)

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.

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)

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.

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.

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.

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)

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.

New

WebSocket: Pending Trades Channel

New Channel: pending-trades

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

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.

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.

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.

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`

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

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`

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

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

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`

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.

​Market-matching endpoints removed

​Sub-cent Kalshi orderbook history

​Market-matching endpoints deprecated

​Trading disabled — withdrawal-only mode in effect

​Trades: multi-wallet filtering and hash lookups

​Multi-wallet filtering

​Order hash and transaction hash filters

​Exact lifetime buy totals: total_bought_usd

​total_shares_bought is deprecated

​Orderbook snapshot limit raised

​Trading API is being retired

​Order Router removed

​Dflow endpoints removed

​New endpoints

Wallet Builder Fees

Position Top Holders

​Polymarket Discovery & Taxonomy

Unified Search

Categories

Tags

Series

​Improvements

​Behavioral changes

​Canonical Markets API

List Canonical Markets

Canonical Venue Listings

Resolve a Canonical Outcome

Search Across Venues

​Order Router

New: Route a single order across every venue

​Unified Transfers

New: One endpoint for every fund movement

​Other improvements

​Connected Wallets: Async Compute + Larger Clusters

​Polymarket V2 Builder Analytics

Leaderboard

Builder Stats

Builder Markets

Builder Timeseries

​List Markets: end_after / end_before Filters

​Cross-Platform Matching: Predict and Opinion Support

​Polymarket Markets: Keyset Pagination

New Endpoint: GET /v2/polymarket/markets/keyset

​Polymarket Events: Keyset Pagination

New Endpoint: GET /v2/polymarket/events/keyset

​Limitless: CLOB Open Interest

​Trading API: Hyperliquid (HIP-4) Support

New Venue: Hyperliquid

​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

Market-matching endpoints removed

Sub-cent Kalshi orderbook history

Market-matching endpoints deprecated

Trading disabled — withdrawal-only mode in effect

Trades: multi-wallet filtering and hash lookups

Multi-wallet filtering

Order hash and transaction hash filters

Exact lifetime buy totals: `total_bought_usd`

`total_shares_bought` is deprecated

Orderbook snapshot limit raised

Trading API is being retired

Order Router removed

Dflow endpoints removed

New endpoints

Polymarket Discovery & Taxonomy

Improvements

Behavioral changes

Canonical Markets API

Order Router

Unified Transfers

Other improvements

Connected Wallets: Async Compute + Larger Clusters

Polymarket V2 Builder Analytics

List Markets: `end_after` / `end_before` Filters

Cross-Platform Matching: Predict and Opinion Support

Polymarket Markets: Keyset Pagination

Polymarket Events: Keyset Pagination

Limitless: CLOB Open Interest

Trading API: Hyperliquid (HIP-4) Support

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