Octav Portfolio API
面向组合和交易记录的 REST API；适合核对协议仓位估值、缓存时间、交易分页与分类。此档案限定标准 API，平台界面和其它付费入口需分别确认。
官方资料核验
访问官方入口 ↗https://docs.octav.fi/api/endpoints/portfolio
适合做什么
- 核对嵌套协议仓位与美元估值
- 区分缓存时间、同步状态和索引完整性
- 排查交易记录日期窗口、分页及分类
- 网络与生态
- Ethereum / Arbitrum / Base / BNB Chain / Polygon / OP Mainnet / Avalanche / Solana / Hyperliquid
- 登录与钱包权限
- 标准 /v1/portfolio、/v1/transactions、/v1/status 业务读取需要 Authorization: Bearer 的 API key；官方 API key 管理入口为 data.octav.fi。教程只检查已有脱敏响应和文档结构，不申请 key 或请求地址数据。
- 费用
- 标准 Portfolio、Transactions 各1 credit/次，Status 0 credits但仍需认证；公开价目 Hobby 400 credits/$10 为文档计划示例，购买前需核实时价格。同步初次还含每250条交易一 credit 的索引费用。认证页写每 key 360次/分钟，零 credit 不等于无限匿名请求或所有产品免费。
局限与核对事项
- API 支持表写65+链并分覆盖等级，平台 quickstart 写90+链；不是相同覆盖承诺。Hyperliquid 列 Portfolio Only；Starknet 两处等级冲突，暂未列入确认范围。
- Portfolio 方法页的完整响应和代码采用对象，支持链页却以数组解构；外层结构须根据已有实际响应确认，未调用业务接口消除矛盾。
- 组合价格、自动交易分类和缓存均为服务提供的数据；未知成本基准、索引遗漏及未分类交易不能通过简单归零消除。
- Portfolio lastUpdated 为毫秒，交易 timestamp 为秒，Status 时间为 ISO8601；同步未进行不能证明数据完整或款项已到账。
- Transactions 概览与交易类型参考的 SEND/TRANSFEROUT 等名称不一致，方法字段 type 与类型页代码 txType 也冲突；保留原响应字段与枚举值，教程不猜测转换。
- 同步费用页面对新增交易与后续同步说明有范围差异；未确认某账户报价、请求表现、UI 扩展或 x402 产品资格。
- 本轮只读文档，未调用业务 API、登录、提交同步、连接钱包、签名或支付。