Changelog

What changed in the archive.

Release notes for 0xArchive API, SDKs, MCP, CLI, exports, and coverage.

v2.2.1New 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
v2.2.0New 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
v2.1.0New 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`
v2.0.0New 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)
v1.9.0New 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
v1.8.0New 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
v1.7.0New 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
v1.6.1New 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
v1.6.0New 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
v1.5.0New 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)
v1.4.1New 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
v1.4.0New 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
v1.3.0New 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
v1.2.0New 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
v1.1.0New Feature
January 5, 2026

OAuth Authentication

Sign in with GitHub and Google for faster onboarding.

  • GitHub OAuth integration
  • Google OAuth integration
  • Automatic account linking
v1.0.2Improvement
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
v1.0.1Bug 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
v1.0.0New 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) for the latest updates and announcements.