财报全文 API：用 DataSinking
检索财报、按章节读取正文

QVeris 已接入 DataSinking 财报工具。接入 QVeris 的 AI Agent 可以先定位公司和报告，再读取章节目录，按问题获取年报章节或财报全文。风险因素、管理层讨论、会计政策与财务附注由此成为可引用的分析材料。你可以从 DataSinking 供应商页查看当前工具范围。

当问题是“收入是多少”时，结构化财务数据通常更直接；当问题是“管理层怎样解释变化”时，则需要报告中的原始叙述。DataSinking 以 Markdown 提供财报内容，具体接口与内容格式见 DataSinking 官方 API 文档。

这条链路的分工是：QVeris 提供工具发现、接入与调用能力；DataSinking 返回报告信息和正文；AI Agent 负责选择阅读范围、分析材料并形成答案。本文说明如何在 QVeris 试用和接入这些工具、查看调用定价，并通过财报案例演示读取与核验流程。

先取得报告 ID，再选择章节，是处理长年报的清晰起点。以下三个入口均为 QVeris 站内工具详情页，可用于查看当前参数与返回说明。

公司身份不明确时，可先在 DataSinking 供应商页查看交易所与股票目录工具。不要猜测文档 ID，也不要把不同交易所的相同本地代码当作同一家公司。

QVeris 将 DataSinking 的报告检索、章节目录和正文读取工具放在同一个发现与调用入口中。你可以先在网页上验证一个财报问题，再将相同工具接入自己的 AI Agent 或应用。

在 QVeris 工具页直接试用

从 DataSinking 工具列表选择所需接口。工具详情页提供 Quick Start、Parameters 和 Execute：Quick Start 展示调用示例，Parameters 用于核对输入要求，Execute 用于填写参数和发起调用。

• 先打开财报元数据工具，按公司、报告类型和报告期查找目标报告。
• 将返回的真实报告 ID 用于章节目录工具，找到实际章节标题。
• 在正文读取工具的 Execute 区域填写 id，按需填写 section。核对调用前价格，按页面提示完成登录与授权，再点击 Run Call。

工具页内置的参数是示例。应将示例 ID 换成自己查询到的报告 ID，避免读到另一家公司或另一个报告期的正文。希望直接用自然语言提出问题时，也可以使用本文底部的 Live Demo 入口。

将 DataSinking 工具接入自己的 AI Agent

在目标工具页点击 Continue setup（继续配置），进入 QVeris AI 接入页面，按照所选 AI 客户端的说明完成连接。该入口会携带已选工具的公开标识，便于后续确认要接入的能力。

连接后，可以向 AI Agent 描述“查询指定公司的年度报告，先列出章节，再读取管理层讨论正文”。让 Agent 在执行前确认当前工具、输入和报价，并依据实际返回的 Markdown 生成答案。完成接入不等于已经执行财报查询。

在应用中通过 REST API 或 SDK 调用

开发者可按 QVeris REST API 文档配置访问凭证。REST 基地址为 https://qveris.ai/api/v1，API Key 通过 Authorization: Bearer 请求头传递；密钥应保存在服务端环境变量中。

若使用 SDK，可从工具页 Quick Start 查看对应调用示例。沿用发现结果中的真实标识与参数契约，将报告查询、目录读取、正文读取串起来；不要把发现工具的响应当作财报正文。

以“Apple 在 2025 财年 10-K 中披露了哪些宏观与贸易风险”为例，先把问题限制到一家公司、一份报告和一个证据目标。

确认公司与报告期

使用财报元数据工具，以 symbol=AAPL、doc_type=annual 等条件定位报告，并核对标题与报告期。report_period 指报告覆盖的期间，announcement_time 是披露时间，两者不能互换。需要“截至某日已披露”的材料时，还要单独核对披露时间。

成功信号是拿到与目标公司、报告类型和期间一致的文档 ID。若列表为空，应报告未找到，并检查代码、市场和期间条件。

先看目录，再选择正文

把上一步返回的 ID 交给章节目录工具，从实际返回标题中选择风险因素章节，再将标题传给正文工具的 section。对于本例，目标是 Item 1A. Risk Factors；如果目录没有该标题，应检查实际章节结构，不凭空构造一个匹配结果。

章节标题可能出现页码、重复项或分隔符。拿到 Markdown 后，检查开头、标题和正文是否真的对应风险因素。章节不存在或模糊匹配错误时，重新核对目录；必要时在明确范围后读取全文。该行为边界见全文或章节工具说明。

带着定位信息形成答案

让 AI Agent 为每项结论保留公司、报告期、章节标题、简短证据和来源。涉及数值时，同时保留币种、单位、合并或分部口径；涉及比率计算时，另取适合的结构化数据，并记录计算输入。

开发者可在 QVeris REST API 文档查看接入方式：Discover 发现工具，按需要使用 Inspect 检查契约或 Probe 校验参数与报价，再执行 Call。工具发现或参数检查完成，并不等于已经取回财报正文。

通过 QVeris 使用 DataSinking 时，可以在供应商页的 Pricing（价格）标签查看工具价格总览，也可以打开具体工具，在 Execute → Before this Call 区域核对调用前价格。

截至 2026 年 10 月 16 日页面核对，以下 5 个工具均显示 1 QVeris credit / call（每次调用 1 积分）。这是当日公开页面显示的工具价格，实际使用前请重新查看当前报价。

如何估算一次财报阅读任务的工具费用

以“查报告 → 列章节 → 读一个章节”为例，若三个工具各调用一次，且均按上表价格计费，工具费用估算为 3 credits。读取更多章节、补查公司信息或增加调用，会改变估算；这一数字不包含可能产生的模型费用。

QVeris REST API 文档说明 Discover、Inspect 和 Probe 免费，Call 按选定工具的 billing_rule 计费。Probe 用于调用前参数检查与报价，不执行供应商请求。最终扣费以调用完成后的 Usage 记录与积分账本为准。

这里的 QVeris credits 与 DataSinking 官网直连套餐属于不同的计费入口。查看直连方案时，应以 DataSinking 官方文档为准，不能将两者的额度或价格直接等同。

本文依据 2026 年 10 月 16 日提供的测试记录整理，使用 AAPL 2025 年 10-K 比较了三条读取路径。任务相同：提取两项有实质内容的风险并给出定位；输入缺少风险因素正文时，不允许凭常识补全。

该案例从章节内容提取了两类风险：宏观环境变化可能影响需求和供应链；贸易限制、关税及地缘冲突可能影响供应、成本与经营。对应主题可在 Apple 2025 年 Form 10-K 的 SEC 官方原文中核对。

这个比较说明的是输入与任务的匹配关系。判断毛利率、收入变化或债务结构时，结构化数据仍有价值；解释风险和管理层判断时，需要相关正文。不能从这个样本推断所有结构化接口都不含风险信息。

测试记录包含下列代表性读取结果。它们说明相同流程可以用于不同语言的材料，不代表每个市场、公司和年度都已完整覆盖。

跨语言输出应保留原始单位、业务名称和期间。以韩国样本中的分部分析为例，某部门营业利润的增速不能改写成公司整体利润或该部门收入的增速；翻译后也不能丢失这些限定条件。

扩展测试记录显示 21 次 Execute 调用返回 success=true，5 条代表性链路形成可用正文；英国样本仅完成报告定位与目录探索。成功状态不等于正文正确率，样本结果也不构成全库覆盖承诺。

长年报通常适合“先目录、后章节”；短季报需要完整上下文时，可以直接全文读取。若只筛选报告，元数据往往足够。元数据工具还支持显式传入字符串 with_content="1" 携带正文，使用前应检查响应规模。

测试记录对同一份贵州茅台 2026 年第一季度报告记录了五种返回方式：

这里的大小是测试记录中业务 JSON 在本地重新编码后的 UTF-8 bytes，不是 token 数，也不是压缩后的网络流量。该短报告的所选章节几乎覆盖全文，因此章节与全文大小接近；不能据此承诺固定的 token 节省比例。

较大的返回结果还可能受平台截断机制影响。回答前先检查正文是否完整；需要完整材料时，按当前工具返回的全文获取方式处理，不能将截断内容当成整份报告。

读到正文只是中间结果。建议把检索证据组织为以下记录，使结论可以回到对应的公司、报告和章节。该表是输出设计建议，字段名称并非 DataSinking API 的统一返回契约。

来源标签与报告 ID 是核验线索，不自动等同于监管机构原文链接。如果响应没有官方地址，应进一步查找并确认；无法找到时，明确标记待核验。对答案中的事实、计算和推断分别表述，材料不足时保留空缺。

需要进一步设计检索、引用和数值验证，可阅读 Financial RAG 指南。需要把财报阅读扩展到完整研究流程，可衔接面向金融研究的 AI Agent。

DataSinking 工具会替代结构化财务接口吗？

两类输入承担不同任务。结构化财务数据适合数值提取、计算和比较；报告正文提供风险、管理层解释与会计语境。AI Agent 可以组合两类结果，但应核对公司、期间和会计口径是否一致。

所有海外年报都能按统一章节名称读取吗？

不能这样假设。不同报告的语言、标题与解析结果可能不同。先读取实际章节目录，再检查匹配正文；遇到页码、重复标题或缺失章节时，调整读取范围，并保留异常状态。

通过 QVeris 调用，与直连 DataSinking 的费用相同吗？

不能直接等同。经 QVeris 调用时，应查看当前工具计费规则，必要时使用 Probe 获取请求报价；直连供应商的 API Key、额度与套餐以 DataSinking 官方文档为准。本文不承诺免费调用或固定价格。

本文是否证明了全市场准确率或固定响应时间？

没有。跨市场案例和返回大小来自上述代表性测试记录。本次仅重新核对公开工具说明、相关资料和链接，没有重新运行整套测试；这些案例不构成 SLA、全库准确率或固定节省比例的证明。

• 财报全文工具：检查正文与章节读取工具。
• 年报章节工具：先确认实际目录与阅读范围。
• DataSinking：查看供应商及其当前工具。
• Financial RAG：组织检索证据与引用。
• AI Agent：将财报材料接入研究工作流。

从 Apple 2025 财年 10-K 开始，定位报告、检查章节，再输出两条附有来源和位置的风险摘要。打开 Live Demo 后，任务会预填到 Playground；检查当前工具、调用条件和计费提示后，由你决定是否运行。