Amberdata订单簿为何缺档？核快照覆盖、价位事件及请求跨度
链小知 · 进阶 · 核验 · 依官方文档整理
按市场/交易所/深度和实际返回范围核数据，不把18个月跨度或分钟快照当全历史逐笔订单。
开始前准备
- 准备自己已有的脱敏材料与请求参数，保留产品、日期、单位和权限说明；缺值不补零。
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、覆盖起止和本人范围明确；旧市场/地址没有当实时完整。
2. 快照与价位事件分开读
官方字典快照为1分钟采样、深度受交易所限制，events是期间价位变化；事件volume=0代表删除，新volume替换此前该价位的值，不是与旧值相加的增量。不能靠分钟快照还原所有撮合；本篇只核已有快照，未运行订单簿重建或请求events。字段numOrders可能因交易所而不同/null，不能当无订单。
检查结果：快照频率、深度和价位替换规则分开；没有把分钟采样写成逐笔完整订单簿。
3. 跨度、边界、时间与层数分别核
startDate含起点、endDate不含终点，可用秒/毫秒/ISO8601；不传则默认前24小时。快照页18个月明确是endDate与startDate最大差，不是最早保留日。timestamp参数只取不晚于指定时点的最近匹配；maxLevel默认最大可用深度，非全市场无限层。timeFormat默认hr并列ms/iso等选项；sortDirection仅最近24小时窗口或未给起止时可用。
检查结果：请求跨度、半开边界、实际最近匹配时点及timeFormat有记录；没有把18个月或maxLevel泛化为覆盖保证。
4. 按metadata.next核真实已返回范围
快照/Information样例均有payload.metadata.next；跟下一页须保留原认证/版本头，next为null才无下一页。requestedStartDate/EndDate与returnedStartDate/EndDate分别保存，不能用请求窗口替代覆盖。通用页另有只含column names的端点用page从0开始，但不能因为某页数据短就给本快照凭空加page。错误或未知shape都留未知，不作空订单簿。
检查结果：实际返回范围、next链与相同对象/版本对应；未把第一页当全年完整数据。
5. 深度字段与历史缺口有界收口
官方样例data给exchange、instrument、timestamp、sequence及ask价位price/volume/numOrders，schema/样例只展示ask而字典称bid/ask都有；未返回bid时不臆造，也不据此确认市场无买单。逐页核对象、深度和时间缺口，旧数据权限/保留边界需本人套餐和实际Information佐证；专业评论所说REST回看限制不能替代本端点的跨度定义。
检查结果：可读买卖侧、实际字段形态与缺档原因保留；未知覆盖或单位不输出完整流动性结论。
怎样确认完成
- 保存对象、原字段、窗口/版本、可核结果与未知分支；文档方法已核，实时数据与本人权限未验证。
常见错误与边界
- Information的多exchange查询与快照的单exchange请求不同。
- 地址、交易所、历史覆盖、保留策略、请求跨度和个人套餐是不同对象，不互相推断。