# Coinalyze历史为何不齐？核合约单位、时间粒度与保留窗口 整理：链小知（AI 辅助） 资料核对日期：2026-10-14 引用地址：https://lianxiaozhi.com/tools/guides/coinalyze-contract-oi-funding-retention-units-check 难度：进阶 核验方式：官方文档整理，未执行真实账户操作 区分当前值和OHLC历史，按每symbol成本和日内留存解释缺口。 ## 使用工具 - [Coinalyze](https://lianxiaozhi.com/tools/coinalyze) · [官方入口](https://coinalyze.net/) ## 前置条件 - 准备已有脱敏截图或响应及请求参数、版本、读取时点；未取得数据保持未知。本篇依官方文档整理，未登录、申请密钥、调用业务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定义毫秒。 核对结果：服务商合约身份与计价单位可追溯，没有只用币种名合并不同合约。 依据：[Coinalyze：OpenAPI字段与参数](https://api.coinalyze.net/v1/doc/api-spec.json) ## 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清算量。 核对结果：当前更新时间、区间时间与三类字段分开，序列未冒充个人资金费结算。 依据：[Coinalyze：OpenAPI字段与参数](https://api.coinalyze.net/v1/doc/api-spec.json) ## 3. 记录历史请求与转换参数 历史from/to均UNIX秒且含边界，interval从1min至12hour或daily。OI和清算历史的convert_to_usd默认字符串false，可用true，资金费率没有同一转换参数。保留原值和实际请求参数，先统一单位再比较，空值或错误不推定零。 核对结果：起止、粒度与转换参数按端点保存，ms/sec没有混用。 依据：[Coinalyze：OpenAPI字段与参数](https://api.coinalyze.net/v1/doc/api-spec.json) ## 4. 按留存说明解释短历史 官方只保留约1500–2000个日内点（1分钟至12小时）并每天删除旧点，daily不按此政策删旧点。长区间请求不能恢复已删数据；返回升序也不代表完整。按实际最早/最晚t和缺口标覆盖，不将daily规则当每个合约从上线起都有数据。 核对结果：留存规则与实际覆盖分别记录，缺历史不解释为没有仓位或清算。 依据：[Coinalyze：API说明与留存](https://api.coinalyze.net/v1/doc/) 依据：[Coinalyze：OpenAPI字段与参数](https://api.coinalyze.net/v1/doc/api-spec.json) ## 5. 核调用成本与错误状态 业务请求用api_key，最多20个symbols，每个symbol计一次API调用；40次/分钟/key不等40个批量请求。429带Retry-After秒数，401为缺/无效key、400为参数、500为服务错误。官方称免费API不等读取无权限，也不等任意再分发许可。 核对结果：symbol数量与API计量匹配，失败保持未知且key未写入记录。 依据：[Coinalyze：API说明与留存](https://api.coinalyze.net/v1/doc/) 依据：[Coinalyze：OpenAPI字段与参数](https://api.coinalyze.net/v1/doc/api-spec.json) ## 常见错误 - 预计资金费、当前费率和实际结算属于不同数据。 - 当前symbol支持、日内留存与网页聚合图刷新不能互推。 ## 完成检查 - 得到带合约、单位、时点和覆盖缺项的历史记录；未实际调用接口不标数据验收。 ## 相关知识 ## 官方依据 - [Coinalyze：API说明与留存](https://api.coinalyze.net/v1/doc/) - [Coinalyze：OpenAPI字段与参数](https://api.coinalyze.net/v1/doc/api-spec.json)