Kaiko两次历史为何不同？核dataset版本、更正与分页固定
链小知 · 进阶 · 核验 · 依官方文档整理
区分API v3、trades.v1及latest数据版本，保留逐笔时间单位冲突。
开始前准备
- 准备自己已有的脱敏材料与请求参数，保留产品、日期、单位和权限说明；缺值不补零。
1. 锁路由、对象及订阅范围
逐笔例路径是{region}.market-api.kaiko.io/v3/data/trades.v1/exchanges/{exchange}/{instrument_class}/{instrument}/trades，region为eu/us；此Spot页例instrument_class=spot，exchange与instrument是服务商code。相同端点可覆盖其他market type，但订阅按市场类型。每个请求要X-Api-Key；公开页套餐清单不证明本人所有市场都授权。
检查结果：region、exchange、instrument_class、instrument与原套餐匹配；未从币名合并不同市场。
2. 数据版本与API版本分别记录
官方数据版本独立于API版本；历史语义变更或纠错产生新dataset version，新增数据不产生新版本。保留query.commodity与query.data_version；latest可能移到破坏性更正，文档当前trades/order_book_snapshots latest=v1只是读取时口径。复核旧新结果先核显式版本，不能凭同为API v3就认定历史不可变化。
检查结果：路径API版本、commodity与实际返回dataset版本都有记录。
3. 固定首轮窗口再核后续页
逐笔start_time ISO8601含起点，end_time不含终点，sort默认desc。首轮可带page_size，后续只用原continuation_token或next_url并保留认证头；窗口/page_size已在token中。latest分页保持首轮实际版本，不能把新发起的另一轮latest查询夹进旧轮，只有首满页不能当全量。
检查结果：同一轮token、query版本和窗口对应；未混合多个版本的页。
4. 逐笔字段不靠通用时间页强转
逐笔timestamp表称Unix纳秒，通用页说所有timestamp为毫秒，逐笔样例13位数呈毫秒，三者冲突保留；缺实际字段契约时不乘除1000。请求/响应metadata时间与每笔trade timestamp分开。trade_id只在exchange内唯一，缺时由Kaiko生成；price为quote currency，amount可能base/quote或contracts，未核单位不直接当美元成交额。
检查结果：时间原值、层级和单位矛盾保存；trade id的唯一范围与amount单位有界。
5. 覆盖与更正原因分开收口
已有response的access.access_range与access.data_range、query.request_time及data分别保留；样例null范围不能解读为无限历史。版本变化、权限范围、未齐页和新交易追加各自记录；缺官方更正说明或原结果时，只指出差异待核，不能声称被修改了哪一笔、实时完整或研究已重现。
检查结果：旧/新结果有版本和已知覆盖；没有用样例或差异反推确定更正事件。
怎样确认完成
- 保存对象、原字段、窗口/版本、可核结果与未知分支；文档方法已核，实时数据与本人权限未验证。
常见错误与边界
- latest固定的是一次分页轮，新的独立查询可能对应新版本。
- 通用分页页含旧v2示例；本篇按已读具体逐笔v3路由，不把示例代码当所有端点规范。