# Amberdata订单簿为何缺档？核快照覆盖、价位事件及请求跨度

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

按市场/交易所/深度和实际返回范围核数据，不把18个月跨度或分钟快照当全历史逐笔订单。

## 使用工具
- [Amberdata Market Data](https://lianxiaozhi.com/tools/amberdata-market-data) · [官方入口](https://www.amberdata.io/)

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

## 1. 固定Spot对象与覆盖Information

已读Spot快照路径为api.amberdata.com/markets/spot/order-book-snapshots/{instrument}，exchange必填且只允许1个；不要把Information支持多个exchange的参数套快照。Information按exchange/instrument给startDate/endDate，includeInactive默认false；列表里历史对象、token address与当前市场仍活跃是不同证据。业务请求x-api-key，api-version按已有请求及metadata保留，示例2023-09-30不是本轮已验证部署版本。

核对结果：Spot、exchange、instrument、覆盖起止和本人范围明确；旧市场/地址没有当实时完整。
依据：[Amberdata：Spot快照参数、返回字段与请求跨度](https://docs.amberdata.io/http/market/spot-order-book-snapshots.md)
依据：[Amberdata：Spot订单簿覆盖Information](https://docs.amberdata.io/http/market/spot-order-book-snapshots-information.md)

## 2. 快照与价位事件分开读

官方字典快照为1分钟采样、深度受交易所限制，events是期间价位变化；事件volume=0代表删除，新volume替换此前该价位的值，不是与旧值相加的增量。不能靠分钟快照还原所有撮合；本篇只核已有快照，未运行订单簿重建或请求events。字段numOrders可能因交易所而不同/null，不能当无订单。

核对结果：快照频率、深度和价位替换规则分开；没有把分钟采样写成逐笔完整订单簿。
依据：[Amberdata：订单簿快照、事件与价位更新](https://docs.amberdata.io/data-dictionary/market/order-books.md)
依据：[Amberdata：Spot快照参数、返回字段与请求跨度](https://docs.amberdata.io/http/market/spot-order-book-snapshots.md)

## 3. 跨度、边界、时间与层数分别核

startDate含起点、endDate不含终点，可用秒/毫秒/ISO8601；不传则默认前24小时。快照页18个月明确是endDate与startDate最大差，不是最早保留日。timestamp参数只取不晚于指定时点的最近匹配；maxLevel默认最大可用深度，非全市场无限层。timeFormat默认hr并列ms/iso等选项；sortDirection仅最近24小时窗口或未给起止时可用。

核对结果：请求跨度、半开边界、实际最近匹配时点及timeFormat有记录；没有把18个月或maxLevel泛化为覆盖保证。
依据：[Amberdata：Spot快照参数、返回字段与请求跨度](https://docs.amberdata.io/http/market/spot-order-book-snapshots.md)

## 4. 按metadata.next核真实已返回范围

快照/Information样例均有payload.metadata.next；跟下一页须保留原认证/版本头，next为null才无下一页。requestedStartDate/EndDate与returnedStartDate/EndDate分别保存，不能用请求窗口替代覆盖。通用页另有只含column names的端点用page从0开始，但不能因为某页数据短就给本快照凭空加page。错误或未知shape都留未知，不作空订单簿。

核对结果：实际返回范围、next链与相同对象/版本对应；未把第一页当全年完整数据。
依据：[Amberdata：Spot快照参数、返回字段与请求跨度](https://docs.amberdata.io/http/market/spot-order-book-snapshots.md)
依据：[Amberdata：Spot订单簿覆盖Information](https://docs.amberdata.io/http/market/spot-order-book-snapshots-information.md)
依据：[Amberdata：next分页、page例外及请求跨度](https://docs.amberdata.io/http/http-pagination-and-timeframes.md)

## 5. 深度字段与历史缺口有界收口

官方样例data给exchange、instrument、timestamp、sequence及ask价位price/volume/numOrders，schema/样例只展示ask而字典称bid/ask都有；未返回bid时不臆造，也不据此确认市场无买单。逐页核对象、深度和时间缺口，旧数据权限/保留边界需本人套餐和实际Information佐证；专业评论所说REST回看限制不能替代本端点的跨度定义。

核对结果：可读买卖侧、实际字段形态与缺档原因保留；未知覆盖或单位不输出完整流动性结论。
依据：[Amberdata：Spot快照参数、返回字段与请求跨度](https://docs.amberdata.io/http/market/spot-order-book-snapshots.md)
依据：[Amberdata：订单簿快照、事件与价位更新](https://docs.amberdata.io/data-dictionary/market/order-books.md)
依据：[Amberdata：Spot订单簿覆盖Information](https://docs.amberdata.io/http/market/spot-order-book-snapshots-information.md)

## 常见错误
- Information的多exchange查询与快照的单exchange请求不同。
- 地址、交易所、历史覆盖、保留策略、请求跨度和个人套餐是不同对象，不互相推断。

## 完成检查
- 保存对象、原字段、窗口/版本、可核结果与未知分支；文档方法已核，实时数据与本人权限未验证。

## 相关知识

## 官方依据
- [Amberdata：订单簿快照、事件与价位更新](https://docs.amberdata.io/data-dictionary/market/order-books.md)
- [Amberdata：next分页、page例外及请求跨度](https://docs.amberdata.io/http/http-pagination-and-timeframes.md)
- [Amberdata：Spot订单簿覆盖Information](https://docs.amberdata.io/http/market/spot-order-book-snapshots-information.md)
- [Amberdata：Spot快照参数、返回字段与请求跨度](https://docs.amberdata.io/http/market/spot-order-book-snapshots.md)