免费公司财务数据 API：先看结论
公司财务数据 API 应帮助应用还原一家发行人连续的财务轨迹：企业在每个报告期披露了什么、何时披露、后来哪些数值发生过修订，以及每项数据如何追溯到原始文件。这与构建覆盖大量公司的因子数据集不同，本页更关注单家公司时间线的完整性和可追溯性，使公司资料页、研究报告、信用审查和财报简报不会混用财务报告期或公司主体。
免费服务通常会限制公司覆盖范围、财务历史跨度、批量下载、请求量、标准化字段或商业用途。
利润表、资产负债表和现金流量表中的数值，只有结合报告期、币种、单位和申报文件来源才有明确含义。
选取有代表性的公司，检查申报文件编号、申报时间、重述记录、缺失数据项和财年安排。
按照实际生效顺序关联财务报表、业绩事件、修订文件、资本变动和财年调整，避免把不同版本混为一谈。
公司财务数据 API 应覆盖哪些内容？
公司财务数据通常包括主体标识、标准化财务报表、分部披露、资本结构、业绩事件、部分衍生比率以及监管申报文件链接。比较供应商前，应先明确公司视图需要覆盖的司法辖区、发行人类型、财务报告频率和历史范围。可靠的响应应通过稳定的公司 ID 与生效日期把这些记录串联起来，而不是只返回彼此割裂的接口快照。
确认法律意义上的发行人、母子公司关系、不同股权类别、主要上市地、注册地、记账本位币、会计准则和合并报表范围。企业并购或重组后，历史比较中所包含的业务边界可能随之变化。
核对年度和季度利润表、资产负债表与现金流量表。每项数据都应包含财务报告期、时点型或期间型标记、币种、单位、合并范围、来源文件，并说明它是企业原始披露值还是供应商标准化值。
公司合计数往往无法解释变化来自哪里。对于较深入的公司资料，应检查按业务分部或地区拆分的收入与利润、企业披露的客户集中度，以及员工数、产量、订阅用户等行业特有经营指标。
持续记录基本股数与稀释后股数、债务、现金、优先证券、少数股东权益、股息、回购、拆股和新股发行。如果股本口径及公司行动调整方式不清楚，每股指标的长期趋势就不可靠。
检查文件提交日期、监管系统接收时间、申报编号、业绩发布日期、修订与重述记录，并保留原始文件链接。首次披露与后续更正应分别保存，才能解释公司财务时间线为何发生变化。
财务报告期、TTM 与重述必须有明确规则
一项财务数据不能只保存“指标名称与数值”。它还应包含发行人、会计概念、期初或时点日期、期末日期、财年、财务期间、币种、单位、合并范围、来源文件和可得时间。即使两条记录都叫“营业收入”，只要一条是单季度、另一条是年初至今累计，或一条仅含持续经营、另一条包含终止经营，就不能直接比较。
实例：从累计值还原单季，避免重复相加
假设某公司披露第一季度收入 100、上半年累计收入 230、前三季度累计收入 360、全年收入 500。对应单季数据应为：Q1 = 100，Q2 = 230 − 100 = 130，Q3 = 360 − 230 = 130，Q4 = 500 − 360 = 140。若直接把 100、230、360 和 500 相加，会重复计算相同期间，得到不可能的全年收入 1,190。
到了下一财年第一季度，假设新单季收入为 110，则滚动十二个月收入可以按 500 − 100 + 110 = 510 更新，但前提是上一全年和两个 Q1 的币种、合并范围与会计口径一致。在无法复现组成期间、调整规则和可得时间前，不应把供应商字段直接标记为 TTM。
当前视图与历史时点视图应保留不同版本
假设公司在 2 月 15 日申报全年收入 500，随后在 5 月 1 日重述为 490。当前公司资料页可以展示 490，同时标注重述并链接新旧文件；但截止时间为 3 月 1 日的历史回测必须读取 500，因为当时更正尚未公开。数据库应保存监管系统接收时间、报告期、申报编号、版本关系和被替代状态，而不是直接覆盖原记录。
公司类型会改变报表模型
收入、销售成本、存货、递延收入、研发支出、资本开支和经营分部通常是核心模型。
利息收入与支出、存款、贷款、信用损失准备、资本充足率和净息差需要银行专属概念。
保费、赔付、准备金、投资收益、综合成本率和法定口径不能强行套入普通工业企业模板。
运营资金、物业指标、合伙结构或行业特有非 GAAP 指标都需要定义与勾稽。
根据任务选择数据来源层
| 来源层 | 优势 | 应用方责任 |
|---|---|---|
| SEC 申报与 Companyfacts | 美国公司一手申报证据、结构化数据项、申报编号、期间、单位与来源追溯。 | 处理会计概念、重复项、维度、修订文件、公司身份与申报可得时间。 |
| 标准化财务数据供应商 | 提供一致指标、跨公司查询、简化 JSON、财务比率与更方便的多市场接入。 | 审计字段映射，保留原始披露值与来源链接，核对免费限制，并测试行业专属覆盖。 |
| 公司投资者关系资料 | 业绩公告、演示材料、业绩指引、经营 KPI 与非 GAAP 勾稽。 | 区分管理层展示与监管报表，并保存发布时间和文档版本。 |
判断公司财务数据是否可靠的关键标准
| 评估维度 | 核验要点 | 免费套餐的常见取舍 | 测试方法 |
|---|---|---|---|
| 覆盖范围 | 公司覆盖、司法辖区、财务报表、数据字段和历史数据跨度。 | 仅覆盖大市值发行人，或仅提供较短的历史数据。 | 分别查询有代表性的发行人、境外发行人和已退市发行人。 |
| 公司模型 | 稳定的发行人 ID、上市关系、子公司、记账本位币与合并范围。 | 直接把一个股票代码等同于整家公司。 | 选择经历过重组或上市关系变化的发行人，核对前后主体映射。 |
| 数据来源 | 申报文件编号、日期、报告期、单位和修订记录。 | 只提供标准化数值，不提供原始来源链接。 | 抽样核对若干数据项，并逐项追溯至原始申报文件。 |
| 时间连续性 | 财年变更、修订、重述、并购与终止经营。 | 最新数值直接覆盖此前的公司历史。 | 重建五年公司时间线，并解释每一个不连续点。 |
| 分部数据 | 业务与地区维度、分部变更、抵销项和与公司合计数的勾稽。 | 仅提供公司合并层面的合计数。 | 将分部收入与公司合并收入进行勾稽核对。 |
| 请求限额 | 每分钟和每日请求限额、并发请求数上限及各接口配额。 | 突发请求容量较低，或设有严格的每日上限。 | 主动触发 429 响应，并检查重试相关响应头。 |
| 数据使用权 | 商业使用、数据存储、署名义务和再分发权限。 | 仅限个人或非商业用途。 | 同时查阅 API 服务条款与上游数据许可。 |
更稳妥地接入公司财务数据
使用稳定的发行人标识，并核对所请求的上市地、股权类别、司法辖区和财务报告主体。结果将面向用户展示时，不能根据一个不带交易所信息的股票代码猜测公司身份。
保存每个标准化指标时，同时保留原始字段、申报文件编号、报告期、币种、计量单位、合并范围和数据获取时间，便于后续审计。除转换后的字段外，还应保留原始响应。
分别处理财年、季度、年初至今期间、滚动期和时点型数据。只有币种、单位、合并范围与报告期一致的数据才可直接比较；对于财年并非自然年的公司，单看自然季度标签并不够。
利用事件发生时间和数据可得时间，将监管文件、业绩公告、修订、财报重述、股息、拆股、证券发行和财年变更合并为一条连续时间线。这样既能保持公司资料最新，也不会抹去历史版本。
检查财务报表恒等关系、现金流衔接、分部数据与公司合计数，以及股本变动。对于缺失值，应区分企业未披露、不适用、数据尚未更新、字段映射失败和供应商错误。
使用 QVeris 发现公司财务数据能力
服务商名录容易过时，而且各 API 对自身能力的描述方式也不尽相同。QVeris 帮助开发者和智能体发现、核验并调用相关公司数据能力，同时保留对输入参数和限制条件的了解。当一个工作流需要从不同工具获取公司概况、财务报表、申报文件数据项或公司事件时，它可以简化能力路由。应用方仍需负责公司主体映射、报告期标准化、来源留存，以及最终向读者作出的解释。
- 按所需能力搜索，例如财务报表、财务比率、公司概况、申报文件数据项或历史基本面数据，而不只按服务商名称搜索。
- 接入自动化工作流前，先检查输入、输出、鉴权方式和限制条件。
- 即使能力发现和调用流程已经简化，也应在应用中保留服务商适配模块和数据来源信息。
常见问题
有。免费数据源可以提供财务报表和监管申报文件，但公司覆盖范围、财务历史跨度、标准化程度、请求配额和商业使用权限各不相同。
应优先核验营业收入、净利润、资产、负债、现金流、财务报告期、币种、单位、申报文件编号和重述记录等字段。
公司财务数据通常用于建立单一发行人可追溯的资料页或财务时间线；基本面数据集还强调跨公司标准化、历史股票池和历史时点面板，以支持选股与回测。
建议同时保存。原始值保留企业实际披露内容，标准化数值便于常规比较；两者并存，分析人员才能核验字段映射，并妥善处理公司特有科目。
首次申报和每次修订都应作为独立版本保存，并记录数据可得时间。当前公司视图可以展示最新版本，但历史研究必须读取当时已经公开的版本。
并非所有产品都需要，但当不同业务或地区的增长、利润率和风险差异明显时，分部数据会显著提高研究质量。各分部合计数应能与公司合并披露完成勾稽。