# Octav Portfolio API

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/octav

面向组合和交易记录的 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、登录、提交同步、连接钱包、签名或支付。

## 操作教程
- [Octav 核对组合响应：协议资产路径、美元估值与缓存时间](https://lianxiaozhi.com/tools/guides/octav-portfolio-value-cache-records)：拆解已有 Portfolio JSON 的仓位层级、单位和更新时间，防止重复累计以及把 N/A 盈亏或同步状态当作零值、实时资产证明。
- [Octav 排查交易漏项：UTC 日期窗口、分页与自动分类](https://lianxiaozhi.com/tools/guides/octav-transactions-date-pagination-labels)：从已有 Transactions 记录找出多一天窗口、过滤遗漏、分页重复和分类差异，保留索引上限与同步时间边界。

## 相关知识
- [链上指标历史数值为什么会变？](https://lianxiaozhi.com/learn/point-in-time-metrics)
- [原始、解码和整理后的链上数据有什么区别？](https://lianxiaozhi.com/learn/raw-decoded-curated-data)
- [浏览器上的价格和标签都是链上数据吗？](https://lianxiaozhi.com/learn/explorer-third-party-labels)
- [区块确认与最终性是什么？交易成功和充值到账为何不同步](https://lianxiaozhi.com/learn/confirmations-and-finality)

## 官方依据
- [Octav：Portfolio 字段与缓存](https://docs.octav.fi/api/endpoints/portfolio.md)
- [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)
- [Octav：API 链覆盖等级](https://docs.octav.fi/api/reference/supported-chains.md)
- [Octav：交易分类与特殊类型](https://docs.octav.fi/api/reference/transaction-types.md)
- [Octav：平台 Quickstart 与 API 范围区分](https://docs.octav.fi/docs/quickstart.md)