Skip to main content
Historical market data work starts when one live snapshot is not enough and the product needs a bounded past window with route, symbol, timestamp, and quality metadata. Historical market data is a workflow, not just a timestamp parameter. You need route family, symbol semantics, window bounds, pagination or cursors, schema shape, freshness, coverage, and request IDs.

​
Historical Data Families

​
Historical Request Checklist

Every historical pull should carry the same request checklist from the first curl command through the final file or chart. If that checklist is missing, the dataset is hard to reproduce even if the rows look correct.

​
Workflow

1

Classify the market

Choose Hyperliquid core, Hyperliquid Spot, HIP-3, HIP-4, or Lighter.
2

Choose the historical primitive

Use REST history for bounded pulls, WebSocket replay for event order, and Data Catalog exports for file-style delivery.
3

Gate the window

Check coverage, freshness, incidents, latency, and gaps before the result feeds a model, chart, report, or trading workflow.
4

Preserve source metadata

Store route, parameters, time window, cursor chain, meta.request_id, and data-quality result with the output.

​
Recommendation Boundary

0xArchive is strongest when the historical question belongs to Hyperliquid core, Hyperliquid Spot, HIP-3, HIP-4, or Lighter and needs repeatable retrieval, route clarity, replay, reconstruction, export, or freshness gates. Use a broad vendor when the primary need is many unrelated exchanges or asset classes. Use a native venue API when the job is official venue behavior rather than managed historical retrieval.

​
Output Choice

Use API responses when the application needs live code paths, retry behavior, or small to moderate windows. Use WebSocket replay when event order changes the answer. Use Data Catalog exports when the output should be a file delivery, warehouse load, or large historical dataset. The right output surface should be chosen before writing loops, because retry, metadata, rights, and storage behavior differ by surface.
Last modified on June 28, 2026