发行人身份
CIK 是稳定主键；股票代码和公司名称可能变化。
版本化申报流程
免费 S-1 API：获取 SEC 申报数据
从首次 S-1 开始，持续跟踪修订、生效、定价和最终结果的证据。
先看 S-1 证据链
IPO 尽调任务
在发行人拥有稳定股票代码前，把原始注册声明与全部修订整理成一条持续变化的发行记录。
最小可用提取
跟踪价格区间、发行股份、售股股东、募集用途、稀释、承销商、风险因素及各数值对应的申报版本。
关键区别
S-1 表示注册意图，并不能证明交易一定启动、在区间内定价、成功上市或不会撤回。
QVeris 的作用
QVeris 帮助 Agent 发现并调用金融数据能力；实际免费额度和使用条款仍由各 API 提供方决定。
把 S-1 看成持续更新的申报过程
首次 S-1
注册声明首次公开披露发行信息。
修订文件
S-1/A 会更新风险因素、财务数据、条款和附件。
招股书
Rule 424 文件可能包含定价和最终发行细节。
生效
EFFECT 表示注册生效，但不等于已经完成上市交易。
最终结果
撤回、延期、定价、上市或其他结果，都要根据证据判断。
从 S-1 申报到定价：按文件链确认发行状态
没有任何一份文件能够单独证明 IPO 的全部阶段。应以发行人 CIK 和注册事项身份构建发行级时间线，再把每份申报和市场事件连同各自的受理时间与证据挂接进去。公开 API 也无法读取仍处于非公开状态的保密草案；公司在 EDGAR 尚无公开文件，并不代表它没有进行上市准备。
| 证据 | 能够确认什么 | 重点字段 | 不能据此推断 |
|---|---|---|---|
| S-1 | 公开注册声明已经提交。 | CIK、申报编号、证券类型、初始披露与受理时间。 | 最终价格、发行完成、上市日或首笔交易。 |
| S-1/A | 注册声明出现了一个新的修订版本。 | 变化后的价格区间、股份、财务期间、风险与附件。 | 最新披露的区间一定成为最终发行价。 |
| EFFECT | 注册声明已经生效。 | 生效日期与时间、关联注册事项。 | 证券已经定价、售出或开始交易。 |
| 424B4 | 最终招股书通常提供更接近最终的发行条款。 | 发行价、最终股份、承销条款、募集金额与稀释。 | 所有配售股份都已交易，或发行结果符合预测。 |
| RW | 发行人请求撤回注册声明。 | 提交时间、关联注册事项及文件中说明的原因。 | 发行人以后不会再次提交注册。 |
| 市场证据 | 上市和首笔交易可通过独立市场记录确认。 | 交易所、股票代码、上市日、首笔交易时间与价格。 | 申报受理时间等于市场启动时间。 |
版本示例：不要用最新值覆盖整个发行过程。
最初的 S-1 可能没有价格和最终股份数量；之后的 S-1/A 可能披露发行 1,200 万股、区间为 18–20 美元；再下一版又可能改成 1,000 万股、区间为 20–22 美元；EFFECT 证明注册声明生效；424B4 最终写明以 21 美元发行 1,000 万股。如果只保存“最新值”，就会丢失预计募集总额从 2.16–2.40 亿美元、变为 2.00–2.20 亿美元并最终落在 2.10 亿美元的过程。每个数值都应绑定申报编号、受理时间、单位、计算情景和来源位置。
先确认文件来源与证据层级
Accession Number
将其作为不可变的申报版本标识。
主文档
保留从申报索引中选中的精确 HTML 或文本文件。
附件
保存附件类型、文件名及其与申报的关系。
表格族
严格区分 S-1、S-1/A、424B、EFFECT 和 RW。
获取证据
保留 SEC 链接、获取时间和解析器版本。
从 S-1 中提取哪些关键字段
| 字段组 | 示例 | 版本规则 |
|---|---|---|
| 发行人 | CIK、法定名称、注册地 | 使用申报当时的身份 |
| 发行信息 | 证券类型、数量、价格区间 | 不能用后续修订回填早期版本 |
| 财务数据 | 期间、报表和审计师 | 保留单位和申报上下文 |
| 风险 | 风险因素及其变化 | 按 accession number 比较 |
| 募集资金用途 | 用途类别和金额 | 区分叙述与量化数据 |
| 证据 | 来源链接、页码/章节、获取时间 | 每个提取结论都附带证据 |
免费 SEC 申报接口的字段与能力
| 层级 | 主要作用 | 适合场景 | 边界 |
|---|---|---|---|
| Form type | S-1 或 S-1/A。 | 区分原始声明与修订文件。 | 不能据此推断 IPO 已完成。 |
| CIK / ticker | 发行人查询键。 | 查询特定公司的 S-1。 | 股票代码可能缺失或变化。 |
| Accession / URL | 唯一申报标识与原始文档。 | 去重与审计追踪。 | 文档解析可能需要另一接口。 |
| Extracted IPO fields | 发行、承销商、募集用途、股东或风险字段。 | 结构化 IPO 研究。 | 覆盖范围取决于提供方和套餐。 |
| 发行方案版本 | 按 accession 保存价格区间、新股与老股数量、超额配售、募集金额和估值假设。 | 解释发行条款如何变化。 | 早期空白字段不等于零，也不能静默用后续值回填。 |
| 资本结构 / 稀释 | 股份类别、转换、期权、认股权证、备考权益与稀释假设。 | 所有权与每股影响分析。 | 计算结果取决于披露的情景与发行版本。 |
| 叙述披露差异 | 新增、删除或修改的风险、募集用途、业务表述与关联交易披露。 | 审查 S-1/A 之间的实质变化。 | 版式和分页变化会制造大量噪声，需要按章节进行比较。 |
按证据推进 S-1 研究
- 01
确认发行人
把名称或代码映射到 CIK，并核对身份。
- 02
收集版本
按时间顺序列出完整表格族。
- 03
获取文档
下载申报索引、主文档和所需附件。
- 04
带证据提取
每个字段同时返回章节、来源链接和 accession。
- 05
比较变化
对修订做差异分析，不把后续事实混入早期版本。
- 06
判断结果
结合 EFFECT、424、RW、交易所和发行人证据。
如何使用免费 S-1 API 获取 SEC 申报
S-1 API 主要服务于 IPO 与注册声明尽调。首次申报公司可能尚无股票代码，因此应从 CIK 开始，按申报顺序整理原始 S-1 与所有 S-1/A，再提取发行方案如何变化，包括拟议价格区间、股份数量、稀释、募集资金用途、售股股东、承销商、风险因素、资本结构和财务报表。提交 S-1 并不意味着 IPO 一定会定价或完成。
注册声明应被视为持续演进的版本档案，而不是 IPO 日历中的一行。早期文件可能没有价格区间或最终发行数量；后续修订可能补充财务期间、更换承销商、改写风险披露、更新售股股东，或改变新股发行与老股出售的比例。真正具有研究价值的，往往是版本之间发生了什么变化，以及这些变化对应的原文证据。
1. 建立修订时间线
按 SEC 接收时间和 accession 排列 S-1 与 S-1/A，通过版本比较追踪变化，不要把每次修订都当作一个新的 IPO 候选。
2. 提取发行结构
跟踪新发行与老股出售、拟议价格区间、募集总额、售股股东、超额配售、承销商及计划上市交易所。
3. 测量稀释与资本结构
保存发行前后股份、不同股权类别、转换假设、期权池和备考资本结构。仅看募集金额无法解释所有权影响。
4. 比较叙述性披露差异
跨修订比较风险因素、募集资金用途、业务描述、关联交易和财务报表。新增或扩展的一段披露，可能比封面数字变化更重要。
5. 把注册声明连接到后续招股阶段
在数据可得时，继续跟踪同一发行对应的招股书文件、生效或撤回事件，并为每个阶段保留表格与 accession。不能仅凭一份 S-1/A 推断最终定价、首日交易或发行完成。
6. 保留附件与引用纳入文件
完整申报材料可能包含承销协议样本、公司章程、重大合同、法律意见、同意函与财务附件。除主要招股书外，还应保存附件类型、顺序、文件名、说明、URL 与版本关系。
S-1 申报 API 示例与验证清单
应把同一注册事项保存为一份带版本列表的档案，而不是把每次修订都发布成新的 IPO。下面的占位示例展示申报证据与提取后的发行条款如何保持关联。
{
"registration_id": "ISSUER_CIK:REGISTRATION_FILE_NUMBER",
"issuer": {"cik": "ISSUER_CIK", "name": "ISSUER_NAME", "ticker": null},
"state": "amended",
"versions": [
{
"accession_number": "INITIAL_S1_ACCESSION",
"form": "S-1",
"accepted_at": "YYYY-MM-DDThh:mm:ss-04:00",
"source_url": "SEC_S1_URL",
"offering": {"shares": null, "price_low": null, "price_high": null}
},
{
"accession_number": "AMENDMENT_ACCESSION",
"form": "S-1/A",
"accepted_at": "YYYY-MM-DDThh:mm:ss-04:00",
"source_url": "SEC_S1A_URL",
"offering": {
"shares": "12000000",
"price_low": "18.00",
"price_high": "20.00",
"currency": "USD",
"source_location": "prospectus-cover"
}
}
],
"outcome_evidence": {"effect_accession": null, "final_prospectus_accession": null}
}发行状态必须由证据驱动。S-1/A 可以支持 amended，却不能证明 effective、priced 或 completed。后续状态只能依据相应的 EFFECT、最终招股书、撤回文件、交易所或市场证据更新，并保留触发每次状态变化的 accession。
按 CIK 与准确表格发现文件
IPO 前发行人可能没有 ticker，因此应使用 CIK，获取 S-1 与 S-1/A，按 accepted timestamp 排序，必要时读取更早 submissions 引用，并把每个 accession 作为同一注册时间线中的独立版本保存。
采集完整申报材料
保存文件索引、主要注册声明、附件、受理时间、申报日和官方 URL，并在解析前为不可变源文件计算哈希。只有来源材料完整，字段提取和后续重放才可靠。
提取版本化字段，而不是只保留“最新值”
价格区间、股份数量、募集金额、承销商、售股股东、稀释与财务期间等字段，都应保存数值、单位、accession、来源章节、提取方式和置信度。空白与区间必须原样保留，不能把早期尚未披露的条款写成零。
按章节比较版本差异
可以消除标题格式与无意义版式差异，但要保留表格和实质正文。重点比较风险因素、募集用途、稀释、资本结构、业务、MD&A、关联交易与财务报表，并用来源锚点展示新增、删除及数字变化。
验证发行结果状态
注册提交、修订、生效、定价、完成、延期与撤回应作为不同状态，并由相应文件或市场证据支持。单独一份 S-1 只能证明注册声明已经公开提交。
调用前检查 SEC 申报能力
使用具体 SEC 能力查询发行人和申报文件，并在每个结果中保留 SEC 原始链接。 可继续打开SEC Submissions 工具，并通过QVeris REST API 参考核对调用契约。
常见问题
SEC 是否提供免费的 S-1 官方 API？
SEC EDGAR 无需 API key 即可提供公开 submissions 元数据和归档注册声明。可按 CIK 查询发行人，筛选 S-1 与 S-1/A，并在遵守当前访问指引的前提下获取完整申报材料。
公司还没有股票代码时能找到 S-1 吗？
可以。CIK 是 SEC 体系中更稳定的发行人标识，尤其适合 IPO 前研究。公司名称和拟议股票代码可能变化，应与 CIK 分开保存，并记录映射的观察时间。
S-1 与 S-1/A 有什么区别？
S-1 是首次公开注册声明，每份 S-1/A 则是独立修订版本。修订可能补充或修改发行条款、财务期间、风险措辞、股东、承销商、附件或其他披露。
提交 S-1 是否意味着 IPO 一定会进行？
不是。它只能证明已经形成公开注册记录，不能保证交易启动、定价、上市或完成。判断结果还需继续跟踪修订文件，以及相应的生效、招股书、撤回和市场事件。
价格区间与发行股份应如何保存？
每个版本都应保存价格上下限、新股与老股数量、超额配售假设、单位、币种、accession 和来源位置。未披露值保持为空，不能用最新条款覆盖历史。
如何比较多份 S-1 修订？
先对齐章节，只消除表面格式噪声，再比较正文、表格与提取字段。重点关注风险因素、募集用途、稀释、资本结构、股东、承销和财务报表，并同时链接两个来源版本。