按分红日历预估未来几个月的现金流入。
Calendar（市场日历）
此类接口提供上市公司关键事件的日程信息，包括财报发布日、分红与除息安排、IPO 上市日程与招股披露文件，以及拆股比例与生效日。做事件驱动策略、安排财报季研究计划，或给行情异动做归因时，先在这里把日期对齐。
典型使用场景
3 个场景按财报日历安排研究与提醒任务。
用拆股记录回溯调整历史行情。
接口怎么选？
7 项选型对照日历类别回答“接下来会发生什么、什么时候发生”。同一件事有两种视角：看单只标的的历史记录，或用区间参数拉全市场在某段时间内的日程。
日历数据会变动：财报日期会推迟、IPO 会取消、拆股比例会调整。做排程或提醒功能时，要保留原始公告日期并定期重拉，不能只存首次拿到的结果。
| 你的需求 | 推荐接口 | 选择理由 |
|---|---|---|
| 查某只股票的分红记录 | Dividends Company公司分红派息 | 含除息日、派息日与金额，做总回报计算 |
| 拉一段时间内的全市场分红 | Dividends Calendar分红派息日历 | 按日期区间筛，做组合现金流预测 |
| 看某只股票的财报历史 | Earnings Report公司财报数据 | 含实际 EPS 与预期 EPS，做业绩超预期分析 |
| 查未来财报发布日程 | Earnings Calendar财报日历 | 按 from/to 拉区间，可带发布时段 |
| 跟踪 IPO 上市安排 | IPOs CalendarIPO 日历 | 含上市日期、交易所与发行价区间 |
| 读取 IPO 招股与披露文件 | IPOs ProspectusIPO 招股书 | 补充发行细节与承销信息 |
| 查拆股历史或即将拆股 | Stock Splits Calendar拆合股日历 | 按区间拉全市场拆股，校准历史价格 |
数据覆盖与参数口径
- 日期口径：均为交易所当地日期，跨市场对比前先统一时区
- 单标的与全市场：带 symbol 的是历史记录，带 from/to 的是区间日历
- 预估与实际：财报日历可能带预期 EPS，实际值以财报接口为准
- 时效性：日程会推迟、取消或调整，需定期重拉
- 分红字段：除息日与派息日是两个不同日期，不要混用
调用示例
Python 关键代码示例场景：按区间拉取财报日历 · 对应接口：Earnings Calendar（财报日历）
Python（核心参数与字段清洗逻辑）
resp = requests.get(
"https://quote-fmp.com/stable/earnings-calendar",
params={"from": "2026-03-06", "to": "2026-06-06", "page": 0, "includeReportTimes": "false", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 epsActual（每股收益实际值）
df["epsActual"] = pd.to_numeric(df["epsActual"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)- from/to 决定区间，不传时容易拿到默认窗口而非你想要的日期段。
- 日期是交易所当地日期，跨市场排程要换算时区。
数据注意事项
4 条实盘要点- 分红数据有单票历史——Dividends Company（公司分红派息）——与全市场区间日历——Dividends Calendar（分红派息日历）——两个入口，合并落库时按
(symbol, date)唯一键去重。 - Earnings Calendar（财报日历） 的
from/to过滤的是财报发布日date（非财年期末），单票历史业绩超预期复盘请使用 Earnings Report（公司财报数据）。 - 计算历史复权因子或核查价格跳空时，结合 Stock Splits Calendar（拆合股日历） 与 Stock Split Details（公司拆合股明细） 校验分子（
numerator）与分母（denominator）方向。 - 一级市场打新与次新股跟踪可组合 IPOs Calendar（IPO 日历）、IPOs Disclosure（IPO 申报文件） 与 IPOs Prospectus（IPO 招股书） 获取发行价区间与招股说明书链接。
常见问题
4 个问题除息日和派息日有什么区别？
除息日是股价扣除股息的交易日，派息日是现金实际到账日，两者通常相隔数周。计算总回报要用除息日。
财报日历里的预期值从哪里来？
来自市场一致预期，会随分析师修正而变动，不同数据源之间也可能不一致，只能作为参考。
IPO 日历为什么经常变？
发行窗口本身具有不确定性，推迟、取消和调整发行价区间都很常见，排程功能要能重复拉取覆盖。
拆股后历史价格需要调整吗？
需要。做时间序列分析前应按拆股比例回溯调整，否则会出现虚假的价格跳空。
接口一览（9个）
4 个功能模块Dividends
2 个接口GETDividends Company
公司分红派息该接口返回指定股票自上市以来的完整历史分红派息序列与已宣告的未来派息计划。逐条记录除权除息日、股权登记日、实际派息日、宣告日、原始每股分红与拆股调整后分红、股息率及派息频率，是红利策略与现金流复权核算的核心数据源。
/stable/dividendsGETDividends Calendar
分红派息日历该接口按自定义起止日期区间返回全市场即将到来或历史已发生的股票分红派息事件日程表。作为横跨全市场的派息雷达，它汇总了各标的的除息日、登记日、派息日、每股分红金额与股息率，直接服务于红利捕获策略与组合现金流日历排期。
/stable/dividends-calendarEarnings
2 个接口GETEarnings Report
公司财报数据该接口返回指定股票的历史各期财报发布记录与未来已排期的财报披露日程。每条记录包含财报发布日期、每股收益（EPS）与营业收入的实际值及市场一致预期值，是开展个股业绩超预期（Beat/Miss）统计与财报事件回测的专用接口。
/stable/earningsGETEarnings Calendar
财报日历该接口按起止日期区间返回全市场上市公司的财报披露日程表，涵盖已发布财报的实际值与预期值对比，以及未来待发布财报的排期预告与市场一致预期。它是财报季全市场业绩跟踪、盘前盘后交易监控与事件驱动选股的核心日历工具。
/stable/earnings-calendarIpos
3 个接口GETIPOs Calendar
IPO 日历该接口按起止日期区间返回全市场即将挂牌或近期已完成首次公开募股（IPO）的新股日历清单。包含新股预计上市日期、公司名称、股票代码、拟挂牌交易所、发行股数、招股价格区间及预估总市值，是打新研究与次新股跟踪的入口数据源。
/stable/ipos-calendarGETIPOs Disclosure
IPO 申报文件该接口按起止日期区间返回拟上市企业向美国证监会（SEC）提交的 IPO 监管申报与注册生效文件清单（如 S-1、F-1、CERT 等表格）。逐条提供申报日期、正式生效日期、CIK 编号、股票代码及 SEC EDGAR 官方文件直链，用于前置追踪新股审批进度。
/stable/ipos-disclosureGETIPOs Prospectus
IPO 招股书该接口按起止日期区间返回近期 IPO 企业最终招股说明书（Prospectus，如 424B4 表格）中的核心发行财务条款与 SEC 官方招股书直链。涵盖公开发行价、承销折价与佣金、扣除费用前的募集资金总额及上市当日收盘价，是新股定价与承销费率分析的专用工具。
/stable/ipos-prospectusSplits
2 个接口准备好接入市场日历相关接口了吗？接口路径与 FMP 保持兼容，替换域名和 API Key 即可开始。
领取 1 个月试用 Key