--- title: "Changelog | 0xArchive" description: "Track 0xArchive API, docs, pricing, coverage, and platform changes across REST, WebSocket, SDK, CLI, and machine-readable surfaces." canonical_url: "https://www.0xarchive.io/changelog/" markdown_url: "https://www.0xarchive.io/changelog.md" route: "/changelog" robots: "index, follow" generated_from: "prerendered_html" --- Changelog # What changed in the archive. Release notes for 0xArchive API, SDKs, MCP, CLI, exports, and coverage. v 2.2.1 New Feature May 6, 2026 ## Spot trades history now goes back to March 2025 Hyperliquid spot trades now cover March 22, 2025 onward, over a year of history. Priority gas auction payments and spot transfers are also available going back several months. - GET /v1/hyperliquid/spot/trades/{symbol}: full trade history with builder fees, twap_id, fee token, and real EVM transaction hashes per fill, back to March 22, 2025 - GET /v1/hyperliquid/spot/orders/{symbol}/history: order lifecycle (open, filled, canceled, rejection variants) for all 294 pairs - GET /v1/hyperliquid/spot/twap/{symbol} and /v1/hyperliquid/spot/twap/user/{user}: TWAP order tracking - GET /v1/hyperliquid/spot/orderbook/{symbol} and /v1/hyperliquid/spot/orderbook/{symbol}/history: L2 order book snapshots and history - GET /v1/hyperliquid/spot/orderbook/{symbol}/l4 and l4/diffs (Pro+): full L4 reconstruction with per-order user attribution - GET /v1/hyperliquid/spot/pairs and /pairs/{symbol}: spot pair metadata for all 294 pairs - Spot orderbook and L4 data remain live-only (May 5, 2026 onward) because Hyperliquid does not publish historical order book snapshots for spot v 2.2.0 New Feature May 5, 2026 ## Hyperliquid spot data live Hyperliquid spot is now a first-class exchange in the archive. 294 pairs covered live from May 5, 2026 onwards via spot-ingester (public WebSocket) and node-ingester (Singapore prod node). - 5 new WebSocket channels: spot_orderbook, spot_trades, spot_l4_diffs, spot_l4_orders, spot_twap - 13 new REST endpoints under /v1/hyperliquid/spot/* (orderbook, trades, orders, twap, pairs, freshness, etc.) - Build+ tier for orderbook, trades, and TWAP. L4 diffs and L4 orders are Pro+ - Symbol convention is dashed: PURR-USDC, HYPE-USDC, HFUN-USDC. Bare tokens (HFUN) also accepted. Server resolves to wire format internally; users never see @107-style ids - L4 lifecycle covers open, filled, canceled, selfTradeCanceled, badAloPxRejected, insufficientSpotBalanceRejected, iocCancelRejected, minTradeNtlRejected - Verbose schema kept: builder address + builder fee per fill, fee token (24+ tokens, not just USDC), real EVM transaction hashes, twap_id joins between fills and parent TWAP orders - No funding rates, no open interest, no liquidations. These are perp-only constructs and do not exist for spot - No historical backfill of orderbook or L4 in this release. Live forward only v 2.1.0 New Feature May 4, 2026 ## Real-Time Liquidations The `liquidations` and `hip3_liquidations` WebSocket channels now stream live, sub-second from a Hyperliquid node. Previously these channels only supported historical replay. - New real-time channels: liquidations (Hyperliquid), hip3_liquidations (HIP-3) — Build+ - Sourced live from the Hyperliquid node's per-block fill data with the `is_liquidation` flag — sub-second latency, no S3 lag - Same wire format as `trades` / `hip3_trades` (each item is a fill record with `is_liquidation: true`), so existing trade-parsing code drops in unchanged - Liquidation events continue to flow on `trades` / `hip3_trades` for backward compatibility — subscribers to both channels should dedupe on `tid` - Available on both wss://api.0xarchive.io/ws and wss://stream.0xarchive.io/ws - Maker + taker still emit separately (one fill = two records, paired by `tid`) — same as the trades channel - Historical replay via `{"op": "replay", "channel": "liquidations", ...}` continues to work; the previous "historical only" gate has been removed for live `subscribe` v 2.0.0 New Feature May 3, 2026 ## HIP-4 Outcome Markets Hyperliquid HIP-4 binary outcome markets are now ingested end-to-end: per-side L2 and L4 order books, trades, open interest, and per-outcome aggregates that combine both sides of a market. - GET /v1/hyperliquid/hip4/outcomes — list outcomes with `is_settled` filter - GET /v1/hyperliquid/hip4/outcomes/{outcome_id} — detail with `aggregated_oi` (paired-set supply, side parity) - GET /v1/hyperliquid/hip4/outcomes/by-slug/{slug} — Hyperliquid-style URL slug lookup - GET /v1/hyperliquid/hip4/instruments, /orderbook/{symbol}, /trades/{symbol}, /openinterest/{symbol} — per-side market data (coins are numeric ids 0, 1, 10, 11, ...; `#`-prefixed form is also accepted) - L4 routes (Pro+): /orderbook/{symbol}/l4, /l4/diffs, /l4/history, /orders/{symbol}/{history,flow,tpsl} - WebSocket channels: hip4_orderbook, hip4_trades, hip4_open_interest (realtime + replay); hip4_l4_diffs, hip4_l4_orders (realtime only, Pro+) - Bulk Parquet exports for hip4 l2_orderbook, l4_orderbook, l4_checkpoints, l4_orders, trades, oi, outcomes - Settlement provenance: each settled outcome records block_number, block_time, and oracle_tx_hash - No funding, liquidations, or candles by design — HIP-4 is fully collateralized binary outcomes; build candles client-side from hip4_trades if needed - mark_price for HIP-4 is implied probability in [0, 1], not USD — mirrors upstream `markPx` on purpose - Coverage begins May 2, 2026 (first day outcomes appeared on chain) v 1.9.0 New Feature April 16, 2026 ## Extended Fill Fee Breakdown Trade/fill responses now include a full fee breakdown: builder fees, HIP-3 deployer fees, priority fees (HYPE burned for write priority), client order IDs, and TWAP execution IDs. - New fill fields: builder_address, builder_fee, deployer_fee, priority_gas, cloid, twap_id - builder_fee — fee charged by the builder/relay that routed the order (in quote currency) - deployer_fee — HIP-3 deployer's trading fee share (in quote currency) - priority_gas — HYPE burned for order write priority (IOC orders on HIP-3) - cloid — client-assigned order ID for tracking fills back to submissions - twap_id — TWAP execution ID for fills belonging to a TWAP parent order - Available on all trade/fill endpoints for Hyperliquid and HIP-3 - Included in Parquet bulk exports and all three SDKs (Python, TypeScript, Rust v1.4.0) - MCP server updated to v1.6.0, CLI updated to v1.4.0 v 1.8.0 New Feature April 4, 2026 ## L2 Full-Depth Orderbook & Reconstruction SDKs Full-depth L2 orderbook endpoints for Hyperliquid and HIP-3, plus orderbook reconstruction helpers in all three SDKs. - GET /orderbook/:symbol/l2 — full-depth L2 snapshot at any timestamp (depth varies by tier) - GET /orderbook/:symbol/l2/history — paginated L2 checkpoints (depth varies by tier) - GET /orderbook/:symbol/l2/diffs — tick-level L2 price-level changes (Pro+) - Available for both Hyperliquid and HIP-3 (6 new endpoints) - L4OrderBookReconstructor in Python, TypeScript, and Rust SDKs — reconstruct L4 and L2 books client-side - New CLI commands: oxa l2 get, oxa l2 history, oxa l2 diffs - 6 new MCP tools for L2 orderbook access - Reconstruction docs: server-side (one API call) and client-side approaches v 1.7.0 New Feature March 16, 2026 ## L4 Order-Level Data & TP/SL History Full order-level orderbooks, order lifecycle events, and TP/SL history for Hyperliquid and HIP-3. - GET /orderbook/:symbol/l4 — L4 orderbook at any timestamp with user attribution (Pro+) - GET /orderbook/:symbol/l4/diffs — individual order changes over time (Pro+) - GET /orderbook/:symbol/l4/history — periodic L4 checkpoints (Build+) - Order lifecycle history, order flow aggregation, and TP/SL order history - Real-time L4 WebSocket channels: l4_diffs, l4_orders, hip3_l4_diffs, hip3_l4_orders (Pro+) - L4 diffs available from March 10, 2026; checkpoints and reconstruction from March 11, 2026 v 1.6.1 New Feature March 4, 2026 ## Full HIP-3 Builder Coverage Expanded HIP-3 support from 29 markets (xyz + km) to all 125+ markets across every active builder. - All 6 builders now supported: xyz (XYZ), flx (Felix Exchange), hyna (HyENA), km (Kinetiq Markets), vntl (Ventuals), cash (dreamcash) - New asset classes: crypto majors (hyna:BTC, hyna:ETH, hyna:SOL), thematic indices (vntl:MAG7, vntl:SPACEX, vntl:OPENAI), commodities (flx:PALLADIUM, flx:PLATINUM), and more - All data types available: orderbook, trades, candles, funding rates, open interest - Data available from March 4, 2026 for new markets v 1.6.0 New Feature February 24, 2026 ## Lighter & HIP-3 Convenience Endpoints Freshness, summary, and pre-aggregated price history now available across Hyperliquid core, Hyperliquid HIP-3, and Lighter.xyz. - GET /v1/lighter/freshness/:symbol, /summary/:symbol, /prices/:symbol - GET /v1/hyperliquid/hip3/freshness/:coin, /summary/:coin, /prices/:coin - Pre-aggregated price history intervals (5m, 15m, 30m, 1h, 4h, 1d) — no client-side rollups needed - Python, TypeScript, and MCP SDKs updated v 1.5.0 New Feature February 18, 2026 ## Multi-Channel WebSocket Replay Stream multiple channels synchronized on a single WebSocket connection. - Replay orderbook + trades + funding + open interest in timestamp order - Synchronized multi-channel replay - Initial replay_snapshot messages for each channel before timeline starts - Lighter.xyz and HIP-3 WebSocket channels (orderbook, trades, candles, OI, funding) v 1.4.1 New Feature February 2, 2026 ## WebSocket Gap Detection Automatic gap detection during historical replay. - Server-side gap detection with configurable thresholds - gap_detected messages notify clients of data gaps - Thresholds: 2 min for orderbook/candles/liquidations, 60 min for trades - SDK support via onGap() / on_gap() callbacks v 1.4.0 New Feature January 28, 2026 ## Data Quality Monitoring New endpoints for monitoring data coverage, incidents, latency, and SLA compliance. - GET /v1/data-quality/status - System health overview - GET /v1/data-quality/coverage - Data coverage by exchange - GET /v1/data-quality/coverage/:exchange/:symbol - Symbol-level gap detection - GET /v1/data-quality/incidents - Incident tracking - GET /v1/data-quality/latency - Real-time latency metrics - GET /v1/data-quality/sla - SLA compliance reporting v 1.3.0 New Feature January 20, 2026 ## Liquidations API Historical liquidation events for Hyperliquid. - GET /v1/hyperliquid/liquidations/:coin - Liquidation history by symbol - GET /v1/hyperliquid/liquidations/user/:user - Liquidations by user address - WebSocket liquidations channel for replay/streaming - Data available from December 2025 onwards v 1.2.0 New Feature January 10, 2026 ## WebSocket Streaming Real-time data streaming via WebSocket connections. - Subscribe to real-time order book updates - Stream live trades as they happen - Funding rate push notifications - Connection health monitoring v 1.1.0 New Feature January 5, 2026 ## OAuth Authentication Sign in with GitHub and Google for faster onboarding. - GitHub OAuth integration - Google OAuth integration - Automatic account linking v 1.0.2 Improvement January 3, 2026 ## Performance Improvements Significant improvements to API response times. - Reduced average response time by 40% - Optimized database queries for order book history - Added response compression for large payloads v 1.0.1 Bug Fix December 28, 2025 ## Bug Fixes Various bug fixes and stability improvements. - Fixed pagination in trades endpoint - Resolved timezone handling in candle data - Fixed rate limit header accuracy v 1.0.0 New Feature December 20, 2025 ## Initial Release Official launch of 0xArchive.io API. - Order book snapshots from April 2023 - Trade history API - Funding rates and open interest - OHLCV candle data - Self-serve API key management - Usage dashboard and analytics Stay updated ## Follow the release stream. Follow us on [X (Twitter)](https://x.com/0xarchiveIo) for the latest updates and announcements.