# Kaiko两次历史为何不同？核dataset版本、更正与分页固定 整理：链小知（AI 辅助） 资料核对日期：2026-10-14 引用地址：https://lianxiaozhi.com/tools/guides/kaiko-trades-dataset-version-pagination-check 难度：进阶 核验方式：官方文档整理，未执行真实账户操作 区分API v3、trades.v1及latest数据版本，保留逐笔时间单位冲突。 ## 使用工具 - [Kaiko Market Data](https://lianxiaozhi.com/tools/kaiko-market-data) · [官方入口](https://www.kaiko.com/) ## 前置条件 - 准备自己已有的脱敏材料与请求参数，保留产品、日期、单位和权限说明；缺值不补零。 ## 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与原套餐匹配；未从币名合并不同市场。 依据：[Kaiko：逐笔交易对象、字段和时间范围](https://docs.kaiko.com/rest-api/cefi-spot-market-data/tick-level-trades.md) 依据：[Kaiko：Market Data认证](https://docs.kaiko.com/rest-api/general/getting-started/authentication.md) ## 2. 数据版本与API版本分别记录 官方数据版本独立于API版本；历史语义变更或纠错产生新dataset version，新增数据不产生新版本。保留query.commodity与query.data_version；latest可能移到破坏性更正，文档当前trades/order_book_snapshots latest=v1只是读取时口径。复核旧新结果先核显式版本，不能凭同为API v3就认定历史不可变化。 核对结果：路径API版本、commodity与实际返回dataset版本都有记录。 依据：[Kaiko：数据版本与API版本独立](https://docs.kaiko.com/rest-api/general/getting-started/data-versioning.md) 依据：[Kaiko：逐笔交易对象、字段和时间范围](https://docs.kaiko.com/rest-api/cefi-spot-market-data/tick-level-trades.md) ## 3. 固定首轮窗口再核后续页 逐笔start_time ISO8601含起点，end_time不含终点，sort默认desc。首轮可带page_size，后续只用原continuation_token或next_url并保留认证头；窗口/page_size已在token中。latest分页保持首轮实际版本，不能把新发起的另一轮latest查询夹进旧轮，只有首满页不能当全量。 核对结果：同一轮token、query版本和窗口对应；未混合多个版本的页。 依据：[Kaiko：逐笔交易对象、字段和时间范围](https://docs.kaiko.com/rest-api/cefi-spot-market-data/tick-level-trades.md) 依据：[Kaiko：continuation_token与next_url分页](https://docs.kaiko.com/rest-api/general/getting-started/pagination.md) 依据：[Kaiko：数据版本与API版本独立](https://docs.kaiko.com/rest-api/general/getting-started/data-versioning.md) ## 4. 逐笔字段不靠通用时间页强转 逐笔timestamp表称Unix纳秒，通用页说所有timestamp为毫秒，逐笔样例13位数呈毫秒，三者冲突保留；缺实际字段契约时不乘除1000。请求/响应metadata时间与每笔trade timestamp分开。trade_id只在exchange内唯一，缺时由Kaiko生成；price为quote currency，amount可能base/quote或contracts，未核单位不直接当美元成交额。 核对结果：时间原值、层级和单位矛盾保存；trade id的唯一范围与amount单位有界。 依据：[Kaiko：逐笔交易对象、字段和时间范围](https://docs.kaiko.com/rest-api/cefi-spot-market-data/tick-level-trades.md) 依据：[Kaiko：通用UTC时间单位说明](https://docs.kaiko.com/rest-api/general/getting-started/api-output/timestamp.md) ## 5. 覆盖与更正原因分开收口 已有response的access.access_range与access.data_range、query.request_time及data分别保留；样例null范围不能解读为无限历史。版本变化、权限范围、未齐页和新交易追加各自记录；缺官方更正说明或原结果时，只指出差异待核，不能声称被修改了哪一笔、实时完整或研究已重现。 核对结果：旧/新结果有版本和已知覆盖；没有用样例或差异反推确定更正事件。 依据：[Kaiko：逐笔交易对象、字段和时间范围](https://docs.kaiko.com/rest-api/cefi-spot-market-data/tick-level-trades.md) 依据：[Kaiko：数据版本与API版本独立](https://docs.kaiko.com/rest-api/general/getting-started/data-versioning.md) 依据：[Kaiko：continuation_token与next_url分页](https://docs.kaiko.com/rest-api/general/getting-started/pagination.md) ## 常见错误 - latest固定的是一次分页轮，新的独立查询可能对应新版本。 - 通用分页页含旧v2示例；本篇按已读具体逐笔v3路由，不把示例代码当所有端点规范。 ## 完成检查 - 保存对象、原字段、窗口/版本、可核结果与未知分支；文档方法已核，实时数据与本人权限未验证。 ## 相关知识 ## 官方依据 - [Kaiko：数据版本与API版本独立](https://docs.kaiko.com/rest-api/general/getting-started/data-versioning.md) - [Kaiko：逐笔交易对象、字段和时间范围](https://docs.kaiko.com/rest-api/cefi-spot-market-data/tick-level-trades.md) - [Kaiko：continuation_token与next_url分页](https://docs.kaiko.com/rest-api/general/getting-started/pagination.md) - [Kaiko：Market Data认证](https://docs.kaiko.com/rest-api/general/getting-started/authentication.md) - [Kaiko：通用UTC时间单位说明](https://docs.kaiko.com/rest-api/general/getting-started/api-output/timestamp.md)