# 0xArchive L4订单簿能续读吗？核检查点、队列和缺口恢复

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/0xarchive-l4-checkpoint-queue-gap-recovery-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

区分在簿状态和订单生命周期，按已保存材料核序列、分页与版本。

## 使用工具
- [0xArchive](https://lianxiaozhi.com/tools/0xarchive) · [官方入口](https://0xarchive.io/)

## 前置条件
- 准备自己已有的脱敏材料与请求参数，保留对象、时间、单位和权限说明；缺值不补零。

## 1. 先锁场所家族和记录深度

Hyperliquid core/Spot/HIP-3/HIP-4分别走自己的L4路径；Lighter为L3，不能套L4状态。L2聚合价位、L4在簿逐订单、order-history/order-flow生命周期各自独立。core/HIP-3 native L2最多20层，全深度/l2由L4派生且历史起点不同，depth=200不让旧native路由变全深度。保存family、symbol、route/schema与时间。

核对结果：场所、深度、在簿状态和生命周期分开，没有用L2替代L4。
依据：[0xArchive：深度模型](https://docs.0xarchive.io/core-concepts/order-book-depth.md)
依据：[0xArchive：路径与检查点字段](https://docs.0xarchive.io/rest-api/order-books.md)

## 2. 固定版本、时点与检查点

新契约REST头为0xArchive-Version:2026-10-01，WebSocket连接URL用同日version；省略则保留旧形状。REST通常RFC3339时间，整数毫秒用_ms后缀；L4旧样例订单timestamp仍整数，新版本改字符串并附timestamp_ms，未知入队时点可null。保留实际响应版本，不按当前日期自动升级解析。checkpoint_timestamp、last_block_number与diffs_applied分别核，0代表干净检查点。

核对结果：版本、原时间形态、检查点和区块明确，旧/新字段未盲目混合。
依据：[0xArchive：版本和分页](https://docs.0xarchive.io/conventions.md)
依据：[0xArchive：路径与检查点字段](https://docs.0xarchive.io/rest-api/order-books.md)

## 3. 按服务器顺序与队列位置更新

L4订阅先l4_snapshot，再有序l4_batch；书页按queue priority排列，不能只按timestamp重排。new-order diff的insert_before有值则插在指定order ID之前，无值才追加队尾；保留bn/oid及原顺序。生命周期l4_orders也使用l4_batch但不等在簿diff，core/HIP-3只带accepted，Spot/HIP-4还可能带rejected与status原因，不能把所有事件直接插入书。

核对结果：队列位置、事件类别和原顺序有依据，未仅按时间或状态名重建。
依据：[0xArchive：队列、排序和缺口恢复](https://docs.0xarchive.io/websocket/l4-orderbook.md)
依据：[0xArchive：深度模型](https://docs.0xarchive.io/core-concepts/order-book-depth.md)

## 4. 分页与覆盖信号不当市场静默

history/diff保留start/end/limit/过滤，cursor原样传并保持其它参数不变；meta.has_more=false才结束，短页仍可有下一页。coverage_from/notice可说明范围早于该symbol，range_before_coverage与unsupported_for_venue是错误，不是零挂单。L4 bid_count/ask_count可为未按depth截断的全检查点计数，不能当所见数组长度；总量与截断深度分开。

核对结果：覆盖、终止标志和截断范围分别核，空页或错误未当市场无订单。
依据：[0xArchive：版本和分页](https://docs.0xarchive.io/conventions.md)
依据：[0xArchive：路径与检查点字段](https://docs.0xarchive.io/rest-api/order-books.md)

## 5. 遇缺口停止输出并重建

发现sequence/replay gap应把状态标为不安全、停止输出，并从新快照/检查点重建或重跑限定窗口，不能跳掉事件继续宣称完整。先保证一symbol能跟上，允许降UI刷新而不能丢书事件；本篇只核已有材料，未连接或重放。REST与WebSocket认证不同，托管MCP另用OAuth；已读文档不证明本人权限、真实队列或重建结果正确。

核对结果：缺口分支和恢复证据明确，未在未知状态输出完整订单簿。
依据：[0xArchive：队列、排序和缺口恢复](https://docs.0xarchive.io/websocket/l4-orderbook.md)
依据：[0xArchive：认证区别](https://docs.0xarchive.io/authentication.md)

## 常见错误
- L2价格/数量多为十进制字符串，L4价格/数量为数值，逐路由核类型。
- 可重放、当前覆盖和原始首次公开可得性不是同一证明。

## 完成检查
- 得到带family、版本、检查点、序列和恢复缺项的记录；真实数据流、队列重建与本人权限未验证。

## 相关知识

## 官方依据
- [0xArchive：认证区别](https://docs.0xarchive.io/authentication.md)
- [0xArchive：深度模型](https://docs.0xarchive.io/core-concepts/order-book-depth.md)
- [0xArchive：路径与检查点字段](https://docs.0xarchive.io/rest-api/order-books.md)
- [0xArchive：版本和分页](https://docs.0xarchive.io/conventions.md)
- [0xArchive：队列、排序和缺口恢复](https://docs.0xarchive.io/websocket/l4-orderbook.md)