Coinalyze历史为何不齐？核合约单位、时间粒度与保留窗口
链小知 · 进阶 · 核验 · 依官方文档整理
区分当前值和OHLC历史，按每symbol成本和日内留存解释缺口。
开始前准备
- 准备已有脱敏截图或响应及请求参数、版本、读取时点；未取得数据保持未知。本篇依官方文档整理，未登录、申请密钥、调用业务API或进行交易。
1. 锁完整合约符号与单位
用已有future-markets材料保存Coinalyze symbol、exchange、symbol_on_exchange、base/quote、is_perpetual与margined。oi_lq_vol_denominated_in可能BASE_ASSET、QUOTE_ASSET或CONTRACTS，不能见BTC就将所有OI当美元；expire_at定义毫秒。
检查结果：服务商合约身份与计价单位可追溯，没有只用币种名合并不同合约。
2. 区分当前值和时间序列
open-interest当前value带update毫秒；open-interest-history是history内t秒加o/h/l/c持仓值，t为区间开始。funding-rate-history的OHLC是费率变动，不能把o/h/l/c相加当结算；liquidation-history用t及l/s分别记该区间long/short清算量。
检查结果：当前更新时间、区间时间与三类字段分开，序列未冒充个人资金费结算。
3. 记录历史请求与转换参数
历史from/to均UNIX秒且含边界，interval从1min至12hour或daily。OI和清算历史的convert_to_usd默认字符串false，可用true，资金费率没有同一转换参数。保留原值和实际请求参数，先统一单位再比较，空值或错误不推定零。
检查结果：起止、粒度与转换参数按端点保存，ms/sec没有混用。
4. 按留存说明解释短历史
官方只保留约1500–2000个日内点（1分钟至12小时）并每天删除旧点，daily不按此政策删旧点。长区间请求不能恢复已删数据；返回升序也不代表完整。按实际最早/最晚t和缺口标覆盖，不将daily规则当每个合约从上线起都有数据。
检查结果：留存规则与实际覆盖分别记录，缺历史不解释为没有仓位或清算。
5. 核调用成本与错误状态
业务请求用api_key，最多20个symbols，每个symbol计一次API调用；40次/分钟/key不等40个批量请求。429带Retry-After秒数，401为缺/无效key、400为参数、500为服务错误。官方称免费API不等读取无权限，也不等任意再分发许可。
检查结果：symbol数量与API计量匹配，失败保持未知且key未写入记录。
怎样确认完成
- 得到带合约、单位、时点和覆盖缺项的历史记录；未实际调用接口不标数据验收。
常见错误与边界
- 预计资金费、当前费率和实际结算属于不同数据。
- 当前symbol支持、日内留存与网页聚合图刷新不能互推。