# Laevitas持仓历史怎么核？分清时间桶、覆盖和历史修订

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/laevitas-perpetual-oi-bucket-completeness-revision-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

按永续持仓的当前官方契约保留单位、桶起止和分页元数据。

## 使用工具
- [Laevitas](https://lianxiaozhi.com/tools/laevitas) · [官方入口](https://laevitas.ch/)

## 前置条件
- 仅核公开文档或自己已有的脱敏材料；不申请密钥、下单或转移资金。
- 分别保存产品、场所、单位、时点与数据缺项，错误不记成零。

## 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差异保留。
依据：[Laevitas：现行v2 OpenAPI及元数据](https://apiv2.laevitas.ch/openapi.json)

## 2. 分清桶标签与实际覆盖

历史条从UTC桶起点标记，1m的15:09覆盖[15:09,15:10)，不是15:09那个瞬间的报价。1m为较细事件的持久化聚合，更粗粒度由这些分钟桶计算。oi_open/high/low/close是首/最高/最低/末有效状态，持仓不可按分钟求和当成交量；schema把open写成桶开始，方法页明确首有效观测，不推定边界恰好有报价。

核对结果：时间桶、首末有效状态和存量/流量区别明确，未对OI求和。
依据：[Laevitas：现行v2 OpenAPI及元数据](https://apiv2.laevitas.ch/openapi.json)
依据：[Laevitas：历史语义与修订](https://apiv2.laevitas.ch/historical-data.html)

## 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相反。

核对结果：请求区间与实际桶覆盖分别核，分页过滤未漂移。
依据：[Laevitas：现行v2 OpenAPI及元数据](https://apiv2.laevitas.ch/openapi.json)

## 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。

核对结果：分页、空原因、观察范围和完整性分别记录，未知/权限不足未当零持仓。
依据：[Laevitas：现行v2 OpenAPI及元数据](https://apiv2.laevitas.ch/openapi.json)

## 5. 保留修订与可获得时间边界

官方说明返回现存且可能更正的历史，不认证最初发布值；观测/计算时间不证明首次公开时间。完整性也不阻止回补、更正改变旧值。按文档中的历史修订feed另核相关端点与窗口；没有实取feed，本篇不列某次修订已应用或断言无事故。通常发布时间不是最迟可用保证，稀疏清算事件最新时间也不代表服务延迟。

核对结果：点时可得性、数值修订和完整性没有互相代替，未读动态状态仍未知。
依据：[Laevitas：现行v2 OpenAPI及元数据](https://apiv2.laevitas.ch/openapi.json)
依据：[Laevitas：历史语义与修订](https://apiv2.laevitas.ch/historical-data.html)

## 常见错误
- 期限合约或当前catalog缺某产品不等历史不能查询；仍逐端点核。
- 持仓OHLC与期权Greeks、资金费或成交量不共用同一单位。

## 完成检查
- 形成可解释边界、单位、分页与修订缺项的持仓记录；实际历史数据和个人权限未验收。

## 相关知识

## 官方依据
- [Laevitas：现行v2 OpenAPI及元数据](https://apiv2.laevitas.ch/openapi.json)
- [Laevitas：历史语义与修订](https://apiv2.laevitas.ch/historical-data.html)