IPOs DisclosureIPO 申报文件
该接口按起止日期区间返回拟上市企业向美国证监会（SEC）提交的 IPO 监管申报与注册生效文件清单（如 S-1、F-1、CERT 等表格）。逐条提供申报日期、正式生效日期、CIK 编号、股票代码及 SEC EDGAR 官方文件直链，用于前置追踪新股审批进度。
https://quote-fmp.com/stable/ipos-disclosure数据更新周期
2-4 Hours
接口说明
- 先于敲钟日历捕获新股申报动向：企业在正式挂牌交易前，必须先向 SEC 提交注册声明并获得交易所认证与生效批复。该接口实时汇总 IPO 相关的监管文件流水，使投研团队能在最终上市日期敲定前提前数周跟踪拟上市企业的合规推进节奏。
- 精准锁定注册生效日与交易所核准表单：返回结果清晰区分申报提交日期与注册生效日期，并标明具体监管表单类型（如交易所核准上市的 CERT 认证函）。当某只热门新股出现生效日期落定且认证表单入库时，往往意味着距离正式挂牌交易仅一步之遥。
- 直达 SEC 原始注册文件合规溯源：每条披露记录均附带对应的 10 位 CIK 编号与 SEC EDGAR 官方档案直达链接，方便一级市场研究员与合规团队一键调阅原始注册声明全文，核查股东背景、同业竞争及风险因素披露。
- 关联数据线接口：Earnings Calendar（财报日历） · Stock Split Details（公司拆合股明细） · Income Statement（利润表） · Stock Price and Volume Data（日线完整行情）
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
from | date | 可选 | 2026-03-06 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-06-06 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
调用代码示例
Python 关键代码针对IPO 申报文件，向 /stable/ipos-disclosure 传入可选 from, to后，响应提供 effectivenessDate（生效日期）、form（申报表单类型）、url（链接地址）（样本 effectivenessDate=2026-07-30）。
resp = requests.get(
"https://quote-fmp.com/stable/ipos-disclosure",
params={"from": "2026-03-06", "to": "2026-06-06", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 IPO 申报文件 核心列：symbol, filingDate, acceptedDate, effectivenessDate
df = df[["symbol", "filingDate", "acceptedDate", "effectivenessDate"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 指定 2025 年初三个月窗口拉取IPO 申报文件 | from=2025-01-01&to=2025-03-31 | 在 /stable/ipos-disclosure 中传入季度起止日期，避免单次跨度过大并提取 effectivenessDate、form、url 共 7 项指标。 |
| 历史滑窗（2024-07 至 2024-12）采集IPO 申报文件 | from=2024-07-01&to=2024-12-31 | 限定 2024-07-01 到 2024-12-31 调用 /stable/ipos-disclosure，提取历史归档所需的 effectivenessDate、form、url 共 7 项属性。 |
/stable/ipos-disclosure 返回 acceptedDate（样本 2026-07-30），但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报，可结合接收时间和时区判断可见性；非美标的、与期末同日的零点时间或回填日期，须先核对原始披露来源。未核实前保留原值，不据此承诺回测已消除前视偏差。
在本地数据仓库归档IPO 申报文件时，以 (symbol, cik, filingDate) 去重可防止重跑产生重复行；其中 effectivenessDate（生效日期，如 2026-07-30）应按字符串（VARCHAR/TEXT）原样保存。
返回数据
7 个字段本接口示例响应共包含 7 个字段（数值型 0 个，文本/日期/布尔型 7 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "QTJA" | 证券代码 |
filingDate | string | "2026-07-30" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
acceptedDate | string | "2026-07-30" | 受理日期（SEC 精确到秒接收时间戳；Point-in-Time 量化回测须以此时间为准以防未来函数） |
effectivenessDate | string | "2026-07-30" | 生效日期 |
cik | string | "0001415726" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
form | string | "CERT" | 申报表单类型 |
url | string | "https://www.sec.gov/Archives/e…" | 链接地址 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "QTJA",
"filingDate": "2026-07-30",
"acceptedDate": "2026-07-30",
"effectivenessDate": "2026-07-30",
"cik": "0001415726",
"form": "CERT",
"url": "https://www.sec.gov/Archives/edgar/data/1415726/000141783526000235/8A_Cert_DDTG_DDFG.pdf"
}
]常见问题解答（FAQ）
2 个问题想拉取「Ipos」相关数据，应该调IPO 申报文件（/stable/ipos-disclosure）还是 IPO 日历？
IPO 申报文件 对应路径 /stable/ipos-disclosure（可选 from, to），涵盖 effectivenessDate（2026-07-30）、form（CERT）等 7 列；IPOs Calendar（IPO 日历） 对应 /stable/ipos-calendar（无必填参数，共 9 列）。
如何基于 /stable/ipos-disclosure 构建稳定的IPO 申报文件定时采集与历史补数任务？
回填或同步 IPO 申报文件 时，请将 [from, to] 拆分为季度或年度滑窗访问 /stable/ipos-disclosure；对返回的 effectivenessDate（生效日期）序列，建议先做排序核对再参与计算。
同模块相关接口对比
Ipos本接口路径 /stable/ipos-disclosure，无必填参数。 同一模块「Ipos」下共 3 个接口，下表列出其余 2 个， 按粒度与查询维度对比，避免选错接口。