Laevitas持仓历史怎么核？分清时间桶、覆盖和历史修订
链小知 · 进阶 · 核验 · 依官方文档整理
按永续持仓的当前官方契约保留单位、桶起止和分页元数据。
开始前准备
- 仅核公开文档或自己已有的脱敏材料；不申请密钥、下单或转移资金。
- 分别保存产品、场所、单位、时点与数据缺项，错误不记成零。
1. 锁当前版本与逐产品单位
本轮静态OpenAPI标v2服务版本1.49.1；GET /api/v1/perpetuals/open-interest须指定完整instrument_name，正文明确不支持currency或跨合约聚合，尽管通用参数schema将instrument_name标非required。按正文保守要求保存该字段。oi_*为base coin，已说明Deribit inverse BTC、USDC linear和Binance USDT-M/COIN-M转换口径，其它场所仍未核，不直接当USD。
检查结果：版本、完整合约和base单位可追溯，正文与schema差异保留。
2. 分清桶标签与实际覆盖
历史条从UTC桶起点标记，1m的15:09覆盖[15:09,15:10)，不是15:09那个瞬间的报价。1m为较细事件的持久化聚合，更粗粒度由这些分钟桶计算。oi_open/high/low/close是首/最高/最低/末有效状态，持仓不可按分钟求和当成交量；schema把open写成桶开始，方法页明确首有效观测，不推定边界恰好有报价。
检查结果：时间桶、首末有效状态和存量/流量区别明确，未对OI求和。
3. 保存边界和分页
start/end为ISO8601 UTC；该端点按桶起点是否在[start,end]筛选。start不对齐会丢包含它的桶，end落桶中仍返回整个桶，可能带end之后的分钟。省start按end或请求时点前24小时，省end无上界；历史窗口应显式保留两界。limit1–1000默认100，cursor取meta.next_cursor并保持过滤、粒度与sort_dir不变；ASC默认最早先，DESC相反。
检查结果：请求区间与实际桶覆盖分别核，分页过滤未漂移。
4. 区分观察范围与完整性
meta.next_cursor为null才是该过滤下无更多页；has_more由额外桶判断，不从短页猜终止。empty_reason区分unsupported_exchange、ineligible_instrument、outside_retention/entitlement/coverage、no_matching_data和classification_unavailable。coverage只给已观察起止，不证中间无缺口；completeness在可用时证明限定半开区间内持久化闭合1m源行齐备，未支持则unavailable。
检查结果：分页、空原因、观察范围和完整性分别记录，未知/权限不足未当零持仓。
5. 保留修订与可获得时间边界
官方说明返回现存且可能更正的历史，不认证最初发布值；观测/计算时间不证明首次公开时间。完整性也不阻止回补、更正改变旧值。按文档中的历史修订feed另核相关端点与窗口；没有实取feed，本篇不列某次修订已应用或断言无事故。通常发布时间不是最迟可用保证，稀疏清算事件最新时间也不代表服务延迟。
检查结果：点时可得性、数值修订和完整性没有互相代替，未读动态状态仍未知。
怎样确认完成
- 形成可解释边界、单位、分页与修订缺项的持仓记录；实际历史数据和个人权限未验收。
常见错误与边界
- 期限合约或当前catalog缺某产品不等历史不能查询；仍逐端点核。
- 持仓OHLC与期权Greeks、资金费或成交量不共用同一单位。