IPOs ProspectusIPO 招股书
该接口按起止日期区间返回近期 IPO 企业最终招股说明书(Prospectus,如 424B4 表格)中的核心发行财务条款与 SEC 官方招股书直链。涵盖公开发行价、承销折价与佣金、扣除费用前的募集资金总额及上市当日收盘价,是新股定价与承销费率分析的专用工具。
https://quote-fmp.com/stable/ipos-prospectus数据更新周期
8-12 Hours
接口说明
- 招股书最终发行条款结构化提取:传统投研需人工翻阅数百页的 SEC 424B4 招股说明书才能找齐发行条款。该接口已将每股公开发行价格、每股及总计承销折扣与佣金、费用前募集资金总额等核心财务数字结构化抽取,可直接入库开展批量统计。
- 新股首日破发与溢价表现量化复盘:接口在同一条记录中并列提供最终公开发行价与上市后市场交易价格。量化研究员可据此一键计算不同行业、不同募资规模新股的首日涨跌幅溢价率与破发比例,评估一级市场发行冷暖周期。
- 投行承销费率测算与原始招股书调阅:通过计算“承销折扣与佣金总额/费用前募集资金总额”,可精确还原各项目的投行承销费率水平;同时配合接口提供的 SEC 招股书全文直链,可随时深入查阅募投项目资金用途与历史备考财务报表。
- 上下游关联接口:Dividends Company(公司分红派息) · Dividends Calendar(分红派息日历) · Global Exchange Market Hours(全球交易所交易时段) · Press Releases(公司新闻稿)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
from | date | 可选 | 2026-03-06 | 查询起始日期,格式 YYYY-MM-DD,包含当天。 |
to | date | 可选 | 2026-06-06 | 查询结束日期,格式 YYYY-MM-DD,包含当天。 |
调用代码示例
Python 关键代码访问 /stable/ipos-prospectus 获取IPO 招股书(可选 from, to),单条记录含 ipoDate(IPO(上市)日期)、pricePublicPerShare(公开发行价格(每股))、pricePublicTotal(公开发行价格总额) 等 13 个字段。
resp = requests.get(
"https://quote-fmp.com/stable/ipos-prospectus",
params={"from": "2026-03-06", "to": "2026-06-06", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 保留上游 acceptedDate 并清洗 pricePublicPerShare;可见时间须另核对披露来源和时区
df["reported_accepted_time"] = pd.to_datetime(df["acceptedDate"], errors="coerce")
df["pricePublicPerShare"] = pd.to_numeric(df["pricePublicPerShare"], errors="coerce")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 限定 2025-01-01 至 2025-03-31 获取IPO 招股书 | from=2025-01-01&to=2025-03-31 | 通过 from 与 to 限定三个月跨度访问 /stable/ipos-prospectus,获取 IPO 招股书 的 ipoDate、pricePublicPerShare、pricePublicTotal(如 2026-07-28)。 |
| 切换 2024-07-01 至 2024-12-31 补齐IPO 招股书 | from=2024-07-01&to=2024-12-31 | 传 from=2024-07-01&to=2024-12-31 访问 /stable/ipos-prospectus,分段建立本地 IPO 招股书 的 ipoDate、pricePublicPerShare、pricePublicTotal 历史底表。 |
/stable/ipos-prospectus 返回 acceptedDate(样本 2026-07-29),但字段名不保证它在所有市场都是实际公开时刻。对经核实的 SEC 申报,可结合接收时间和时区判断可见性;非美标的、与期末同日的零点时间或回填日期,须先核对原始披露来源。未核实前保留原值,不据此承诺回测已消除前视偏差。
从 /stable/ipos-prospectus 抽取 pricePublicPerShare(样本 1)入库时,以 (symbol, cik, filingDate) 建唯一索引可安全支持断点续传。
返回数据
13 个字段本接口示例响应共包含 13 个字段(数值型 6 个,文本/日期/布尔型 7 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "FTW-WT" | 证券代码 |
acceptedDate | string | "2026-07-29" | 受理日期(SEC 精确到秒接收时间戳;Point-in-Time 量化回测须以此时间为准以防未来函数) |
filingDate | string | "2026-07-30" | 申报日期(监管申报日期;若同表含 acceptedDate,实盘事件对齐应优先取 acceptedDate) |
ipoDate | string | "2026-07-28" | IPO(上市)日期 |
cik | string | "0002083125" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
pricePublicPerShare | number | 1 | 公开发行价格(每股) |
pricePublicTotal | number | 434 | 公开发行价格总额 |
discountsAndCommissionsPerShare | number | 0 | 折让与佣金(每股) |
discountsAndCommissionsTotal | number | 82251 | 折让与佣金总额 |
proceedsBeforeExpensesPerShare | number | 1 | 发行费用前所得(每股) |
proceedsBeforeExpensesTotal | number | 82251 | 发行费用前所得总额 |
form | string | "S-1" | 申报表单类型 |
url | string | "https://www.sec.gov/Archives/e…" | 链接地址 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "FTW-WT",
"acceptedDate": "2026-07-29",
"filingDate": "2026-07-30",
"ipoDate": "2026-07-28",
"cik": "0002083125",
"pricePublicPerShare": 1,
"pricePublicTotal": 434,
"discountsAndCommissionsPerShare": 0,
"discountsAndCommissionsTotal": 82251,
"proceedsBeforeExpensesPerShare": 1,
"proceedsBeforeExpensesTotal": 82251,
"form": "S-1",
"url": "https://www.sec.gov/Archives/edgar/data/2083125/000121390026082963/ea0298363-s1_presidio.htm"
}
]常见问题解答(FAQ)
2 个问题如何区分「Ipos」模块的IPO 招股书与 IPO 日历?/stable/ipos-prospectus 的传参要求是什么?
两者的差异在于入口与字段集:/stable/ipos-prospectus(IPO 招股书)要求可选 from, to并产出 13 列(含 ipoDate=2026-07-28);IPOs Calendar(IPO 日历)要求无必填参数并产出 9 列。
拉取 /stable/ipos-prospectus 的IPO 招股书数据时,如何处理历史回溯、空结果判定或代码格式?
针对 /stable/ipos-prospectus,推荐利用 from 至 to 闭区间对 /stable/ipos-prospectus 做分段回溯;这样既能稳定获取 ipoDate(IPO(上市)日期),又能避免单次请求载荷过大。
同模块相关接口对比
Ipos本接口路径 /stable/ipos-prospectus,无必填参数。 同一模块「Ipos」下共 3 个接口,下表列出其余 2 个, 按粒度与查询维度对比,避免选错接口。