免费股票基本面数据 API
开发者指南
选择免费基本面数据源时，应综合考察字段覆盖、申报日期、
时点历史数据、请求频率限制与使用许可，而不只是端点数量。
核心摘要
SEC EDGAR 提供美国上市公司的申报文件与公司事实数据，但开发者需要自行规范这些记录。
商业 API 简化了财务报表与比率的使用，但免费套餐通常会限制额度或历史深度。
使用申报日期和点时记录，避免历史筛选产生前视偏差。
缓存申报文件、保留原始响应，并确认数据展示或再分发权限。
股票基本面 API 应包含哪些数据
API 应提供利润表、资产负债表、现金流量表、币种、会计期间与申报日期。股票筛选还可能需要股本、企业价值、利润率、增长率与估值比率。
字段名称相同也可能采用不同口径，例如原始披露值、标准化值、滚动十二个月计算结果或不同的重述处理规则。采用某套数据结构前，应测试会计年度特殊的公司和修订申报文件。
应保留报表类型、财年、季度、起止日期、申报表单、合并范围、业务分部、币种、单位和数量级。脱离这些维度的单个数值没有明确含义。
期末股本、基本加权平均股数和稀释加权平均股数必须区分。EPS、市值和每股比率不能默认共用同一个分母。
供应商计算的比率要与企业原始披露事实分开保存，并记录公式、分子、分母、期间对齐方式，以及负值和缺失值的处理规则。
为什么申报日期与时点历史数据很重要
报告期末表示经营活动发生的时间，申报时间则表示市场何时能够获知该信息。十二月的报告若在次年二月申报，就不能用于一月的历史回测。应同时保存两个日期、修订状态、来源、单位与版本。
股票筛选可以接受每日更新，事件研究则需要可靠的时间戳。应缓存变化较慢的历史数据，把请求额度留给新申报文件。
至少要保存三类时间：会计期间末、原始申报受理时间，以及本地采集或供应商可用时间。修订申报出现时，应追加新版本，不要覆盖历史策略当时能够看到的记录。TTM 指标也应使用目标日期已公开的四个季度重新计算，而不是把今天接口返回的 TTM 值直接填入过去。
免费基本面数据源对比
| 数据源 | 主要优势 | 免费访问方式 | 注意事项 |
|---|---|---|---|
| SEC EDGAR | 权威的美国申报文件与 XBRL 公司事实数据 | 公共 JSON 端点 | 需自行规范数据并控制请求频率，主要覆盖美国市场 |
| Alpha Vantage | 财务报表、公司概况、盈利与行情数据 | API 密钥与有限额度 | 端点额度与标准化计算口径 |
| Financial Modeling Prep | 便于开发的财务报表、比率与公司资料 | 部分免费端点或免费套餐 | 需确认当前覆盖范围与商业使用权 |
| Provider marketplace | 通过统一发现层查找多种数据能力 | 取决于具体供应商 | 逐项核查数据时效、额度与使用许可 |
可靠的接入检查清单
- 统一证券身份：建立证券代码、交易所、CIK 或其他永久标识符的映射。
- 保留原始数据：转换数据前先归档每次来源响应。
- 谨慎规范字段：保留币种、数量级、会计期间、单位、分类标准与来源。
- 遵守请求限制：使用缓存、条件更新、退避机制和可识别的用户代理。
- 验证历史结果：仅使用目标日期当时可获得的信息复现筛选结果。
- 核查使用权：免费访问未必允许展示、再分发或用于模型训练。
发布标准化报表前，应增加自动勾稽检查：资产应在合理误差内等于负债加权益，现金流小计需要按明确容差对齐，单位不能悄悄变化，年度值也不能与季度值混用。供应商调整字段或重述历史数据时，应抽取小样本回到原始申报逐项核对。
使用 QVeris 查找合适的基本面数据能力
需要标准化公司指标时，可打开 Financial Modeling Prep 关键指标工具，并查看对应的服务商页面。用于选股或回测前，仍要核对期间、单位、计算方法、更新时效与访问条款。
常见问题
SEC EDGAR 提供公开的美国申报文件。商业 API 的免费套餐通常会限制额度、历史深度或可用端点。
可以从财务报表、股本、会计期间、申报日期、币种与来源信息开始。
可以，但必须包含点时可用性与修订记录。
按文档 ID 缓存数据，在支持时批量请求，并使用退避机制重试。
参考资料与下一步
Alpha Vantage 文档
Financial Modeling Prep 文档
QVeris 关键指标工具
Financial Modeling Prep 服务商页面