用途：Octav API 面向开发者，用于查询加密货币投资组合、交易历史与 DeFi 分析数据，覆盖 50 多条区块链网络。基础地址为 https://api.octav.fi，认证方式为请求头中的 Bearer Token，接口按信用点计费，速率限制 360 次/分钟/密钥。
主要能力：REST 接口提供 25 个端点，包括 /v1/portfolio（跨链与协议持仓）、/v1/nav（净资产值，支持法币与加密货币计价）、/v1/wallet（钱包余额，不含 DeFi 头寸）、/v1/transactions（可过滤的交易历史）、/v1/historical（历史组合快照）、/v1/approvals/{chain}（ERC-20 授权记录）、/v1/token-overview（按协议拆分代币，PRO）、/v1/airdrop（Solana 可领取空投）、/v1/sync-transactions（手动触发同步）以及免费端点 /v1/status、/v1/credits、/v1/chains 等。另有 5 个 x402 支付协议端点（/v1/agent/portfolio、wallet、nav、status、chains），每次调用 0.025 USDC（Base 网络），无需 API 密钥。
使用方式：默认使用带 Bearer Token 的 /v1/* 接口，密钥建议存入环境变量 OCTAV_API_KEY，切勿硬编码。仅当用户明确要求 x402 或按次付费、或智能体自有资金钱包且无 API 密钥时，才使用 x402 端点。请求示例：curl -X GET "https://api.octav.fi/v1/credits" -H "Authorization: Bearer YOUR_API_KEY"。交易历史不支持 x402，必须有 API 密钥。
适用场景：多钱包组合汇总、净值换算、交易与 DeFi 操作记录查询、历史快照、空投与授权检查等。建议批量传入地址以节省信用点，先调用 /v1/status 与 /v1/credits 等免费端点，并在服务端过滤参数。
限制与错误：401 密钥无效、402 信用点不足、403 需 PRO 订阅、429 超限需重试、404 地址未索引（超过 10 万笔交易）。首次索引按每 250 笔交易 1 信用点计费。免费与付费端点、PRO 与订阅要求不同；部分链仅支持组合查询。价格、套餐与信用点有效期以公开资料所列为准，其它细节暂未提供。