# Octav 排查交易漏项：UTC 日期窗口、分页与自动分类

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/octav-transactions-date-pagination-labels
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

从已有 Transactions 记录找出多一天窗口、过滤遗漏、分页重复和分类差异，保留索引上限与同步时间边界。

## 使用工具
- [Octav Portfolio API](https://lianxiaozhi.com/tools/octav) · [官方入口](https://docs.octav.fi/api/endpoints/portfolio)

## 前置条件
- 准备已有脱敏 /v1/transactions 请求、各页 JSON 响应、HTTP 状态和时间；保留查询参数与内部地址标签，去掉 API key。
- 如要核对同步时点，准备同地址已有 /v1/status 记录；不新增地址读取、同步 POST、认证请求或付费调用。

## 1. 确认路径、外层结构和覆盖

核对 https://api.octav.fi/v1/transactions，必填 addresses、limit、offset。响应是含 transactions 数组的对象，而非直接返回交易数组。

limit允许1–250，offset从0起。先核对目标网络的交易覆盖；组合支持并不代表交易也支持，例如 Hyperliquid 在 API 表列 Portfolio Only。

核对结果：请求和响应结构一致，目标网络有交易覆盖依据，未把解析失败当作无历史。
依据：[Octav：Transactions 分页、日期与分类](https://docs.octav.fi/api/endpoints/transactions.md)
依据：[Octav：API 链覆盖等级](https://docs.octav.fi/api/reference/supported-chains.md)

## 2. 检查 UTC 窗口与参数命名

startDate 是 ISO8601 精确包含的起始瞬间；endDate则忽略传入时分秒，包含其 UTC 日到23:59:59Z。查询单日可将两者设为相同日期，如2026-10-01。

endDate写成次日00:00:00Z会包含整个次日，连续日报可能重复一天。必须使用 camelCase 的 startDate/endDate；start_date/end_date 按文档会400。

核对结果：窗口起止以 UTC 写清楚，未多含一天，参数名称与已存请求一致。
依据：[Octav：Transactions 分页、日期与分类](https://docs.octav.fi/api/endpoints/transactions.md)

## 3. 复原搜索和隐藏条件

逐项记录 networks 链 key、protocols、txTypes、interactingAddresses、initialSearchText、hideSpam、hideDust；后两项默认false。搜索可匹配符号、名称、合约和说明文字，不能将文本搜索当作唯一 Token 身份证明。

比对不同记录前先对齐过滤条件。方法页列SEND/RECEIVE/APPROVE，类型参考却用TRANSFEROUT/TRANSFERIN/APPROVAL；方法正文字段为 type，类型页代码又用 txType。保留原响应外层、字段名和枚举值，不猜测别名转换或自动改筛选。

核对结果：漏项排查保留所有过滤条件及原始 type，文档名称冲突明确待核。
依据：[Octav：Transactions 分页、日期与分类](https://docs.octav.fi/api/endpoints/transactions.md)
依据：[Octav：交易分类与特殊类型](https://docs.octav.fi/api/reference/transaction-types.md)

## 4. 检查已有分页并识别重复

sort 默认DESC。按已有 limit、offset、sort 对照页序：limit为50时，常见已存页偏移应为0、50、100。仅检查已有记录，不为了补齐自动发新请求。

同一组过滤条件下用 chain.key 与 hash 标注跨页重复；如果索引期间数据更新或页缺失，保留缺口。没有总条数或稳定快照证据，不能仅凭一页短结果宣布历史完整。

核对结果：已存页范围可追溯，跨页重复与缺页单列，没有将分页条数当作全部链上交易数。
依据：[Octav：Transactions 分页、日期与分类](https://docs.octav.fi/api/endpoints/transactions.md)
依据：[Octav：同步状态与免费额度边界](https://docs.octav.fi/api/endpoints/status.md)

## 5. 核对秒级时间、收付资产与分类

timestamp 为 epoch 秒，和 Portfolio 的毫秒字段不同。交易 value/fees 按文档为原币，valueFiat/feesFiat 为美元；assetsIn/assetsOut 的数量字段为 balance，身份字段为 contract、chainKey、chainContract。

自动 type 源于方法签名、协议和转账模式；MULTITYPE、INTERACTION、UNDEFINED 等保留原标签。SELFTRANSFER标签不能替代地址控制权证明，APPROVAL 也不是收款凭证，收付方向需结合资产明细而非只看 from/to。

核对结果：每条交易的网络、hash、时间、资产数量与单位可还原，标签未被当作安全或到账证明。
依据：[Octav：Transactions 分页、日期与分类](https://docs.octav.fi/api/endpoints/transactions.md)
依据：[Octav：交易分类与特殊类型](https://docs.octav.fi/api/reference/transaction-types.md)

## 6. 保留索引上限、状态和费用边界

超过100000条交易的地址按文档不自动索引；404可能与大地址索引限制有关，401/402/429分别保留认证、credits、速率问题。Transactions 每次1 credit，错误不能解释成零交易。

Status交易缓存为十分钟，transactionsLastSync为ISO8601；syncInProgress=false只说明没有该同步过程。整理已覆盖窗口、过滤、页范围、重复、缺口与最新同步时刻，不提交 sync 或推断费用豁免。

核对结果：得到明确边界的历史核对结果，超限、失败和缓存不足仍列待核。
依据：[Octav：Transactions 分页、日期与分类](https://docs.octav.fi/api/endpoints/transactions.md)
依据：[Octav：同步状态与免费额度边界](https://docs.octav.fi/api/endpoints/status.md)
依据：[Octav：API Bearer 与速率](https://docs.octav.fi/api/authentication.md)
依据：[Octav：标准 API credits 费用](https://docs.octav.fi/api/pricing.md)

## 常见错误
- endDate取次日午夜，误把次日全部历史带入当日报。
- 改变 hideSpam/hideDust 或 type 过滤后仍直接比较条数。
- 混淆秒与毫秒；把自动标签、HTTP200、无同步进程或空数组当作到账与完整性证明。

## 完成检查
- 整理已有交易记录的 UTC 窗口、过滤条件、分页、分类与索引缺项，能定位具体请求和 hash。
- 仅依据文档核对流程；未获取新地址历史、执行同步、验证实际到账或运行付费 API。

## 相关知识
- [浏览器上的价格和标签都是链上数据吗？](https://lianxiaozhi.com/learn/explorer-third-party-labels)
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)
- [代币授权是什么？断开钱包与撤销授权有什么区别](https://lianxiaozhi.com/learn/token-approvals)

## 官方依据
- [Octav：Transactions 分页、日期与分类](https://docs.octav.fi/api/endpoints/transactions.md)
- [Octav：交易分类与特殊类型](https://docs.octav.fi/api/reference/transaction-types.md)
- [Octav：API 链覆盖等级](https://docs.octav.fi/api/reference/supported-chains.md)
- [Octav：同步状态与免费额度边界](https://docs.octav.fi/api/endpoints/status.md)
- [Octav：API Bearer 与速率](https://docs.octav.fi/api/authentication.md)
- [Octav：标准 API credits 费用](https://docs.octav.fi/api/pricing.md)