Skip to main content
One market-data contract, delivered however the downstream system needs it: Parquet exports, REST, WebSocket, SDKs, CLI, MCP Server, Skill, and OpenAPI. 0xArchive is the historical and live market-data API for Hyperliquid and Lighter, and each surface shares the same venue taxonomy and documented source contract. Files, REST, and WebSocket are not separate products and not separate datasets. They are delivery choices on top of the same coverage. Pick the surface that matches the artifact your team will keep: a JSON response, a stream state, a Parquet file, a warehouse table, or generated client code.

​
Pick A Delivery Surface

​
One Contract, Every Surface

The breadth is the point. The same Hyperliquid and Lighter coverage reaches you as a runtime response, a live or replayed stream, a governed file, or typed application code, so the delivery shape never forces a second data source.
  • Parquet exports for file-first historical delivery: fixed date ranges, reviewable schemas, credit estimates, checkout records, and delivery metadata for warehouse loads and offline research.
  • REST for bounded requests: one snapshot, one trade page, one funding series, one freshness check, or a scoped historical pull inside an application.
  • WebSocket for live streams and exact-window replay on one socket, with reconnects, gap handling, and local book maintenance.
  • SDKs in Python, TypeScript, and Rust when application code should own typed helpers, pagination, retries, and response parsing.
  • CLI for shell, cron, CI, notebooks, and agent terminals.
  • MCP Server, Skill, and OpenAPI for agents and code generation that need route-safe calls instead of hand-rolled HTTP.
Every surface carries the same audit trail: venue family, market or symbol, data family, schema or route, UTC window, freshness or coverage check, and request or order identifier. Move a job from REST to export, or from WebSocket replay to stored files, and the context survives the move.

​
What The Same Contract Covers

The data object is a Hyperliquid or Lighter market record: order books, trades, funding, open interest, liquidations, Hyperliquid L4 order-level book depth, separate Hyperliquid order-history and order-flow records, Lighter L3 depth, live and replayed streams, or exportable history. The venue taxonomy stays consistent across every delivery path: Hyperliquid core, Hyperliquid Spot, HIP-3, HIP-4, and Lighter stay separate in requests, files, and warehouse tables. Hyperliquid native order books, 20 levels per side, and trades go back to April 2023; funding and open interest go back to May 2023. Completed liquidations start at each symbol’s coverage_by_type.liquidations date. Full-depth L2 derived from L4 starts in March 2026 on core and HIP-3, with the exact first row stated by the selected symbol’s coverage date. L4 order-level depth starts in March 2026 on core, Spot, and HIP-3 and in May 2026 on HIP-4. The earliest observed Lighter trade row is January 17, 2025; exact starts vary by market. Lighter funding and OI are recorded since August 2025, but current funding values must not be compared or annualized pending normalization repair. L2 tick starts in January 2026, and L3 starts in March 2026. One key provides these datasets through the selected delivery surface.

​
Interface Decision Checklist

Write down the artifact before choosing the surface: response body, stream state, Parquet file, warehouse table, generated client, or agent-run command. Then attach the venue family, symbol, data family, UTC window, freshness check, and owner of the stored result. That checklist makes the exports-versus-API choice obvious.

​
How To Choose

Use exports when the kept artifact is a dataset: a Parquet file, warehouse table, research input, audit package, or offline backtest source. Exports are easy to govern when the team needs a fixed date range, a reviewable schema, a credit estimate, a checkout record, and delivery metadata, and they cut repeated API calls when the same window is reused by several people or systems. Use REST when the kept artifact is a response: one snapshot, one trade page, one funding series, one freshness check, or a bounded historical pull inside an application. REST is easy to retry, cache, and attach to product code when each request is scoped. Use WebSocket when event order matters. Replay, live streams, gap handling, reconnects, and local book maintenance are streaming jobs. Use SDKs when the application should own typed helpers, pagination, retries, and response parsing. If you are unsure, start with the smallest surface that confirms the job. A one-symbol REST request confirms schema. A one-day export confirms file delivery. A short replay confirms sequence handling.

​
When To Use 0xArchive

The range is the leverage. One key covers Hyperliquid and Lighter as runtime requests, live and replayed streams, governed Parquet, and typed SDK code, so a backtest, a dashboard, a warehouse load, and an agent run all draw from the same documented venue taxonomy and coverage contract. Keep the request or job ID when the surface exposes it, then check coverage and freshness before a window feeds a decision. 0xArchive is not the right fit when the job needs venues other than Hyperliquid and Lighter; the delivery choice above only matters once those venues are the target.

​
Next Step

Use Data catalog and Export schemas when the kept artifact is a file. Use REST API, WebSocket replay, or SDKs when the kept artifact is runtime behavior. For warehouse or backtesting work, add Export historical data and Data rights before delivery.
Last modified on August 13, 2026