# MatrixAlpha 产品复权净值 API 请将管理员交给你的 Token 配置到 Agent 的凭据管理器或环境变量 `MATRIXALPHA_NAV_TOKEN`。请求发往提供本说明的同一 HTTPS 站点,在请求头中使用 `Authorization: Bearer `。所有查询使用 GET。 ## 快速查询 | 目标 | 路径和参数 | | --- | --- | | 列出产品分类 | `/api/agent/v1/categories` 返回分类的 `id` 和 `name` | | 列出指定分类的产品 | `/api/agent/v1/products?category=cta` 返回 `fundCode` 和 `fundName` | | 提取某一分类的全部历史 | `/api/agent/v1/nav?category=cta` | | 查询单只产品或日期区间 | `/api/agent/v1/nav?category=cta&code=B2050A&start=2026-10-01&end=2026-11-13` | `category` 使用分类列表中的 ID。`code`、`start`、`end` 均可省略,日期使用 YYYY-MM-DD 并包含首尾两天。省略日期即可读取该分类当前发布产品的完整历史。 净值响应含有 `rows` 和 `nextCursor`。每一行包含 `fundCode`、`fundName`、`date`、`frequency` 和 `adjustedNav`。`adjustedNav` 是产品库记录的复权净值数值,保留原始精度。只返回有效复权记录。同一估值日如发布了多种频率,会保留各频率记录。用产品代码、日期和频率共同标识一条记录。 默认每页 1000 条,可用 `limit` 指定 1 至 5000 条。将返回的 `nextCursor` 作为下一次请求的 `cursor` 参数,使用 URL 参数编码,保留原分类、产品代码和日期条件,直至 `nextCursor` 为 `null`。翻页期间发布数据发生变化会返回 409,此时丢弃这一批已读页,从第一页重新读取。 401 表示凭据缺失、到期或已撤销。403 表示凭据无权访问该模块。404 表示分类或接口不存在。503 表示分类数据暂时不可用。指定产品或时间段没有已发布数据时,返回空的 `rows`。 ## 给 Agent 的提示词 把示例中的「本站接入说明地址」替换为本说明的完整网址。管理员后台复制的提示词已带入实际站点地址。 **提取整个分类** > 按「本站接入说明地址」使用已配置的 MATRIXALPHA_NAV_TOKEN,提取 CTA 分类所有产品的完整历史复权净值。读完所有分页,按产品代码、名称、估值日、频率和复权净值输出 CSV。 **查单只产品** > 按「本站接入说明地址」使用已配置的 MATRIXALPHA_NAV_TOKEN,查询 CTA 产品 B2050A 在 2026-10-01 至 2026-11-13 的复权净值,按估值日和频率列成表。