Octav 排查交易漏项：UTC 日期窗口、分页与自动分类
链小知 · 进阶 · 核验 · 依官方文档整理
从已有 Transactions 记录找出多一天窗口、过滤遗漏、分页重复和分类差异，保留索引上限与同步时间边界。
开始前准备
- 准备已有脱敏 /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。
检查结果：请求和响应结构一致，目标网络有交易覆盖依据，未把解析失败当作无历史。
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 写清楚，未多含一天，参数名称与已存请求一致。
3. 复原搜索和隐藏条件
逐项记录 networks 链 key、protocols、txTypes、interactingAddresses、initialSearchText、hideSpam、hideDust；后两项默认false。搜索可匹配符号、名称、合约和说明文字，不能将文本搜索当作唯一 Token 身份证明。
比对不同记录前先对齐过滤条件。方法页列SEND/RECEIVE/APPROVE，类型参考却用TRANSFEROUT/TRANSFERIN/APPROVAL；方法正文字段为 type，类型页代码又用 txType。保留原响应外层、字段名和枚举值，不猜测别名转换或自动改筛选。
检查结果：漏项排查保留所有过滤条件及原始 type，文档名称冲突明确待核。
4. 检查已有分页并识别重复
sort 默认DESC。按已有 limit、offset、sort 对照页序：limit为50时，常见已存页偏移应为0、50、100。仅检查已有记录，不为了补齐自动发新请求。
同一组过滤条件下用 chain.key 与 hash 标注跨页重复；如果索引期间数据更新或页缺失，保留缺口。没有总条数或稳定快照证据，不能仅凭一页短结果宣布历史完整。
检查结果：已存页范围可追溯，跨页重复与缺页单列，没有将分页条数当作全部链上交易数。
5. 核对秒级时间、收付资产与分类
timestamp 为 epoch 秒，和 Portfolio 的毫秒字段不同。交易 value/fees 按文档为原币，valueFiat/feesFiat 为美元；assetsIn/assetsOut 的数量字段为 balance，身份字段为 contract、chainKey、chainContract。
自动 type 源于方法签名、协议和转账模式；MULTITYPE、INTERACTION、UNDEFINED 等保留原标签。SELFTRANSFER标签不能替代地址控制权证明，APPROVAL 也不是收款凭证，收付方向需结合资产明细而非只看 from/to。
检查结果：每条交易的网络、hash、时间、资产数量与单位可还原，标签未被当作安全或到账证明。
6. 保留索引上限、状态和费用边界
超过100000条交易的地址按文档不自动索引；404可能与大地址索引限制有关，401/402/429分别保留认证、credits、速率问题。Transactions 每次1 credit，错误不能解释成零交易。
Status交易缓存为十分钟，transactionsLastSync为ISO8601；syncInProgress=false只说明没有该同步过程。整理已覆盖窗口、过滤、页范围、重复、缺口与最新同步时刻，不提交 sync 或推断费用豁免。
检查结果：得到明确边界的历史核对结果，超限、失败和缓存不足仍列待核。
怎样确认完成
- 整理已有交易记录的 UTC 窗口、过滤条件、分页、分类与索引缺项，能定位具体请求和 hash。
- 仅依据文档核对流程；未获取新地址历史、执行同步、验证实际到账或运行付费 API。
常见错误与边界
- endDate取次日午夜，误把次日全部历史带入当日报。
- 改变 hideSpam/hideDust 或 type 过滤后仍直接比较条数。
- 混淆秒与毫秒；把自动标签、HTTP200、无同步进程或空数组当作到账与完整性证明。