Skip to main content

When Checkpoint History Is Enough and When You Need Order-Level Depth

8 min read

A question-first framework for deciding when checkpoint history is enough, when full L4 and order-level routes matter, and how to test the threshold on one Hyperliquid event window.

If interval snapshots answer the question, use checkpoint history. If the answer depends on events between checkpoints, use order-level data such as L4, order flow, or TP/SL history.

If you are choosing between native venue data and managed history, compare the two sources here.

Short answer: checkpoint history is enough when you care about state at intervals and do not need to explain what happened inside them. Order-level depth becomes necessary when queue movement, trigger behavior, user attribution, or intra-interval order flow can change the answer.

Three practical layers of depth

Every level from the best bid to the wallet, shown on one order book, is in level 1 vs level 2 vs level 3 market data.

Layer

Typical surface

How to decide

Top-line market history

Trades, candles, funding, open interest, liquidations

Use it when you need regime context, timing, or broad filters, not state reconstruction.

Checkpoint history

Replay state and l4/history checkpoints

Use it when interval state is enough and you need reproducible reruns.

Order-level depth

orderbook/l4, diffs, order flow, TP/SL

Use it when the answer changes because of what happened between checkpoints.


Route-level guide

Question

Public route or surface to inspect first

Why

Can replay alone explain the event window?

Replay/backtesting docs

Start with replay lifecycle and state handling before you assume you need deeper depth.

Do I need checkpoint state at intervals?

/v1/hyperliquid/orderbook/{symbol}/l4/history

Checkpoint history is the first test when interval snapshots may already preserve the answer.

Do I need to study order placement and cancellation pressure?

/v1/hyperliquid/orders/{symbol}/flow

Order flow helps when the path between checkpoints matters more than the checkpoint itself.

Do triggers or TP/SL events matter?

/v1/hyperliquid/orders/{symbol}/tpsl

Trigger history shows the sequence of trigger events when that sequence matters to the answer.

Do I need full order-level reconstruction?

/v1/hyperliquid/orderbook/{symbol}/l4

Full L4 is for path-dependent questions where interval checkpoints are not enough.

When checkpoint history is enough

  • You want replayable snapshots for backtests and incident reviews.

  • You are measuring changes at discrete intervals rather than queue behavior tick by tick.

  • You need something closer to state reconstruction than candles offer, but not user attribution or trigger history.

  • You care more about repeatable reruns than every intra-interval order mutation.

0xArchive's Build tier enables replay and checkpoint history, with detailed REST API docs to cover deeper order-level routes.

Do not buy depth for these cases

  • Broad regime filters, volatility context, and top-line event timing.

  • Discrete replay snapshots that already explain the incident window.

  • Offline studies where a checkpoint or export already preserves the state you need.

  • Cases where you are only reaching for depth because it feels safer, not because the answer changes between intervals.

When order-level depth is actually necessary

  • You are studying queue position, microstructure behavior, or what happened between checkpoints.

  • You need to inspect order flow, TP/SL triggers, or user-attributed order behavior.

  • You need full L4 reconstruction rather than interval checkpoints alone.

  • You are investigating path-dependent events where the order sequence matters as much as the resulting state.

One-symbol depth test

Run one event window twice. First, inspect the window through checkpoint history or replay. If checkpoint replay already explains the event, stay in Build territory. If the unresolved answer lives between checkpoints, test the corresponding Pro-level route on the same symbol and the same window.

  1. Pick one event window where the answer may depend on intra-interval behavior.

  2. Review it first through checkpoint history or replay.

  3. Write down what remains unresolved.

  4. If the unresolved question lives inside the interval, inspect the matching order-level route.

  5. Use the parity guide to compare the work required to reproduce the same window natively and with managed history.

Build versus Pro as one decision rule

Use Build when the unanswered question is still about replay, checkpoint state, or interval-level reruns. Use Pro when the unanswered question depends on order-level behavior, trigger history, or full L4 reconstruction.


Create a key, test one event window at checkpoint depth, and move to Pro if the unresolved question lives inside the interval.

Sources