Changelog

​

Dflow endpoints removed

​

New endpoints

​

Polymarket Discovery & Taxonomy

​

Improvements

​

Behavioral changes

​

Canonical Markets API

​

Order Router

• 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.

​

Unified Transfers

• 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.

​

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.

​

Connected Wallets: Async Compute + Larger Clusters

• 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.

​

Polymarket V2 Builder Analytics

​

List Markets: end_after / end_before Filters

​

Cross-Platform Matching: Predict and Opinion Support

• /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.

​

Polymarket Markets: Keyset Pagination

​

Polymarket Events: Keyset Pagination

​

Limitless: CLOB Open Interest

​

Trading API: Hyperliquid (HIP-4) Support

• 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.

• 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".

• 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.

​

WebSocket: Crypto Prices Channel

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

​

WebSocket: Explicit role on order_filled

• 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.

​

Connected Wallets Endpoint

​

Trades: V2 Exchange Fields

• 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.

​

Cross-Platform Matching: Limitless Support

• /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.

​

Per-Token Candlesticks

​

Activity: CONVERT Events + NegRisk Fields

• 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.

​

WebSocket: Conversion Events & Pending Trade Gating

​

WebSocket: Token IDs on condition_prepared

• 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.

​

WebSocket: Polymarket V2 Support

• 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)

​

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

• 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.

​

WebSocket: Orderbook Channel

• 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 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

• 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

​

Schema Updates

​

Dflow Support

• 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

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