美股财报日历与除息拆股排期去哪找?告别网页临时扒数据:FMP 四大市场事件日历自动化接入指南(Earnings & Dividends Calendar API)

在美股事件驱动交易、红利轮动及投研周报自动化管线中,网页爬虫维护日历常遭遇 DOM 改版断流、盘前(BMO)与盘后(AMC)披露时段缺失、除息日与派息日混用,以及把仙股反向合股(Reverse Split)误判为正向拆股等工程事故。通过接入 Calendar(市场日历接口)分类下的 9 个标准化 REST 接口,工程团队可将“全市场时间窗扫描”与“单标的历史回溯”收拢为一套自动化数据流。

本文基于 FMP 生产网关(https://quote-fmp.com/stable)2026 年 11 月实盘报文(数据快照截至 2026-11-13),拆解财报、分红派息、股票拆合股及新股上市(IPO)四大市场事件日历的参数契约、对账公式与工程防坑要点,并附可投产的 Python 持仓事件雷达脚本。


做美股事件驱动策略与投研周报,为什么靠财经网页爬虫抓财报与除息排期总是掉链子?

依赖网页爬虫维护事件日历,通常会在四个环节掉链子:① 缺乏“全市场时间窗扫描(from / to)”与“单标的十年历史回溯(symbol)”双轨拆分;② 缺失 bmo(盘前)与 amc(盘后)披露时段及排期确认状态(confirmed),导致对冲脚本在当日开盘前误平盘后才发财报的仓位;③ 未适配 2024 年 5 月 28 日美股切换 T+1 交收后的除息日规则及累计拆股复权股息口径;④ 忽略端点单次 4,000 行返回上限与全球多市场后缀混杂,整月拉取直接触发截断漏报。

FMP 将市场事件体系拆分为“横截面日历”与“单标的历史明细”两层共 9 个端点,工程分工如下:

事件维度接口名称(标准锚文本)网关路径(/stable/...)查询模式与核心参数工程定位与核心产出字段
财报排期Earnings Calendar(财报日历接口)/stable/earnings-calendar时间窗 from、to + includeReportTimes=true批量扫描未来/历史窗口全市场财报排期、盘前盘后时段与一致预期
财报历史Earnings Report(公司财报数据接口)/stable/earnings单标的 symbol + limit + includeReportTimes=true单公司历年各季 epsActual vs epsEstimated 及营收超预期对账
派息排期Dividends Calendar(分红派息日历接口)/stable/dividends-calendar时间窗 from、to(建议按 7 至 15 天切片)全市场除息日(date)、登记日、派息日、派息频率与动态股息率扫描
派息历史Dividends Company(公司分红派息接口)/stable/dividends单标的 symbol + limit单公司历史派息序列,提供原始股息 dividend 与复权股息 adjDividend
拆股排期Stock Splits Calendar(拆合股日历接口)/stable/splits-calendar时间窗 from、to(可按月或按年拉取)全市场正向拆股与反向合股排期,返回 numerator 与 denominator
拆股历史Stock Split Details(公司拆合股明细接口)/stable/splits单标的 symbol + limit单公司历次拆合股精确生效日与折算比例,用于重算历史 K 线复权因子
新股排期IPOs Calendar(IPO 日历接口)/stable/ipos-calendar时间窗 from、to拟上市与已定价新股排期、挂牌交易所、发行股数、招股区间与募资规模
上市确权IPOs Disclosure(IPO 申报文件接口)/stable/ipos-disclosure时间窗 from、to交易所挂牌核准文件(CERT 表单)受理日、生效日与 SEC 归档原文链接
招股说明书IPOs Prospectus(IPO 招股书接口)/stable/ipos-prospectus时间窗 from、to招股书(424B4 / S-1/A)公开发行价、每股承销佣金折扣与募资净额明细

未来一周哪些美股发财报?如何用财报日历接口(Earnings Calendar)批量获取披露日期与 EPS / 营收一致预期?

构建每周财报日历或期权跨式策略时,核心是处理好 /stable/earnings-calendar 与 /stable/earnings 的端点单次 4,000 行上限与可选参数 includeReportTimes=true。

1. 端点单次 4,000 行上限与多市场代码后缀过滤

向 /stable/earnings-calendar?from=2026-11-01&to=2026-11-30 发起整月查询时,该端点精确返回 4,000 条记录。因结果按日期降序排列,这 4,000 条仅覆盖 2026-11-13 至 11-30 共 16 个自然日,11 月 1 日至 12 日排期被截断;其中不含点号(.)的美股代码占 1,285 条,其余 2,715 条为 .L、.T、.DE、.HK 等海外代码。

因此生产管线应落实两条规则:

2. 开启可选参数 includeReportTimes=true:解锁盘前盘后时段与确认状态

默认调用仅返回 7 个基础字段(symbol、date、epsActual、epsEstimated、revenueActual、revenueEstimated、lastUpdated)。显式传入 includeReportTimes=true 后,响应扩展至 12 个字段,新增 5 个关键属性:

下表以 4 条代表性记录展示开启 includeReportTimes=true 后的待披露排期与已披露超预期对账(采样时间 2026-11-13):

股票代码披露日期 (date)财年财季 / 会计期末时段 (time) / 状态预期 / 实际 EPS (美元)预期 / 实际营收 (亿美元)
NVDA2026-11-172027财年Q3 (2026-10-26)amc (盘后) / 已确认2.47 / 待披露1,088.39 / 待披露
NVDA2026-08-262027财年Q2 (2026-07-26)amc (盘后) / 已披露2.09 / 2.22 (+6.22%)922.71 / 962.21 (+4.28%)
HD2026-11-172026财年Q3 (2026-11-02)bmo (盘前) / 已确认3.84 / 待披露428.14 / 待披露
DE2026-11-252026财年Q4 (2026-11-02)bmo (盘前) / 预估排期4.03 / 待披露104.04 / 待披露

如表所示,迪尔(DE)虽有预期值与 bmo 标识,但 confirmed 为 false,提示需防日期微调;财报发布后调 /stable/earnings?symbol=NVDA&includeReportTimes=true 即可如第 2 行所示,直接核算出 +6.22% 的 EPS 超预期幅度与 +4.28% 的营收超预期幅度。


高股息策略必查的分红派息日历(Dividends Calendar):除息日(date)、股权登记日与派息日怎么精准对齐?

/stable/dividends-calendar 与 /stable/dividends 返回相同的 9 个核心字段:symbol、date、recordDate、paymentDate、declarationDate、adjDividend、dividend、yield 与 frequency。/stable/dividends-calendar 整月查询同样触及 4,000 行上限(无点号代码 2,186 条),而 15 天窗口(11-13 至 11-27)返回 2,060 条(无点号代码 1,000 条),建议按 7 至 15 天切片拉取。

1. 四个分红关键日期与美股 T+1 交收制度的实盘映射

2. 原始股息 dividend 与累计拆股复权股息 adjDividend 的对账公式

当公司发生过拆合股时,dividend 记录派息当期按拆股前原始股数宣告的金额,而 adjDividend 记录按该次派息之后历次拆股累计比例折算的后复权股息(adjDividend = dividend / 此后累计拆股折算因子)。下表以 4 条代表性记录验证 T+1/T+2 日期映射与跨拆股复权逻辑:

股票代码宣告日 (declarationDate)除息日 (date)登记日 (recordDate)派息日 (paymentDate)原始股息 (dividend)复权股息 (adjDividend)股息率 (yield) / 频率
AAPL2026-11-022026-11-122026-11-122026-11-160.270.270.3015% / Quarterly
O2026-11-102026-11-302026-11-302026-12-150.2740.2745.4868% / Monthly
AVGO2024-06-122024-06-242024-06-242024-06-285.250.5251.2781% / Quarterly
NVDA2021-05-262021-06-092021-06-102021-07-010.160.0040.0922% / Quarterly

表中最后两行清晰验证了累计拆股折算:AVGO 在 2024-06-24 除息后于 2024-07-15 实施 1 拆 10,故 dividend = 5.25 除以 10 得 adjDividend = 0.525;NVDA 在 2021-06-09 除息后先后经历 2021-07-20 的 1 拆 4 与 2024-06-10 的 1 拆 10(累计 4 × 10 = 40 倍),故原始股息 0.16 除以 40 得 adjDividend = 0.004。回测准则:若使用仅做拆股调整的复权收盘价(详见 美股 30 年历史日线与分钟级 K 线建库实战),算股息率必须配对 adjDividend;若使用未复权原始价则配对 dividend;若使用已含现金分红复权的总回报序列,切勿再次叠加股息。


股票拆合股(Stock Splits Calendar)与新股上市(IPOs Calendar & Prospectus)排期去哪一站式拉取?

1. 拆合股日历(splits-calendar)与历史明细(splits):结合 splitType 与 numerator / denominator 严防反向合股陷阱

/stable/splits-calendar 与 /stable/splits 每条记录含 5 个字段:symbol、date、numerator(折算后新股数)、denominator(折算前老股数)及 splitType。

实测 2026 全年(截至 2026-11-13 快照)439 条全球记录中,399 条标为 "stock-split" 的记录同时包含 132 条正向拆股(numerator > denominator)与 267 条反向合股(numerator < denominator,常见于仙股缩股保壳或 ETF 净值归拢),两者共用同一枚举值;其余记录则涵盖 "stock-dividend"(股票股利)、"adr-change"(ADR 换股比例调整)等公司行动。在 199 条无点号美股代码记录中,numerator < denominator 占 159 条(79.9%),正向占 40 条(20.1%)。因此代码须结合 splitType 与 factor = numerator / denominator 判定方向,4 类代表性样本如下:

股票代码生效日期 (date)分子 (numerator)分母 (denominator)原始 splitType实际业务方向与价格除权乘数
NVDA2024-06-10101stock-split正向拆股(1 股拆为 10 股,价格乘数 0.10)
BITO2026-11-1912stock-split反向合股(2 股合为 1 股,价格乘数 2.00)
EMBJ2026-11-1641adr-changeADR 换股比例调整(比例 4:1,价格乘数 0.25)
UWHR2026-11-05103100stock-dividend股票股利派送(每 100 股送 3 股,乘数 0.9709)

2. 新股上市三剑客:ipos-calendar、ipos-disclosure 与 ipos-prospectus 的联动对账

FMP 通过三个互补接口还原从招股书递交、挂牌核准到定价上市的完整链条(新股上市后的 SEC 表单检索可参阅 美股 10-K 财报文本与 SEC 公告检索方案):

  1. /stable/ipos-calendar:2026 年 9–11 月窗口共返回 218 条记录(NASDAQ 174 条、NYSE 44 条;"Expected" 待上市 114 条、"Priced" 已定价 104 条)。daa 字段对应上市日美东零点的 ISO UTC 时间戳(EDT 为 T04:00:00.000Z,EST 为 T05:00:00.000Z)。
  2. /stable/ipos-disclosure:返回交易所挂牌核准文件(form 为 "CERT")。关键去重规律:9–11 月窗口虽返回 10,411 条记录,但去重后仅对应 272 个独立 PDF 链接(url)和 191 个独立发行人(cik)(因成熟公司如 META/METAM 发行多档票据或衍生代码时,同一份 PDF 被挂在几十个关联代码下重复返回),入库应先按 url 或 cik 去重。
  3. /stable/ipos-prospectus:同窗口返回 207 条记录(含 424B4 终稿 44 份、S-1/A 76 份、S-1 72 份、F-1/F-1/A 15 份),提供公开发行价 pricePublicPerShare、承销佣金 discountsAndCommissionsPerShare 与扣除其他发行费用前的每股净募资额 proceedsBeforeExpensesPerShare(满足 proceedsBeforeExpensesPerShare = pricePublicPerShare - discountsAndCommissionsPerShare)。

三表联动时需注意三点口径:① "Priced" 已定价记录满足 shares × pricePublicPerShare == dealSize;② "Expected" 待定价记录的 dealSize 通常按招股区间上沿并计入 15% 超额配售权估算;③ 仅递交 S-1/A 初步招股书的 SPAC 发行人(如 Harbour Island Acquisition Corp.,代码 HRIA,每单位 Unit 10 美元、承销费率 4.5%)出现在 ipos-prospectus 中,尚未进入 ipos-calendar。3 类代表性新股跨表对账如下:

股票代码公司名称 / 交易所 (exchange)上市/招股日阶段 (actions / form)发行数量 / 发行价承销佣金 / 除费用前净募资募资总额 (dealSize) / 接口 marketCap
TRXBTRex Bio Inc. (NASDAQ)2026-10-09Priced / 424B4833.33 万股 / 14.00美元0.98美元 (7.0%) / 13.02美元1.17 亿美元 / 市值 3.84 亿
VVVVvVARDIS Holding AG (NYSE)2026-11-13Expected / 待定价952.38 万股 / 21.00 - 24.00美元待定 / 待定2.63 亿美元 (含超配) / 待定
HRIAHarbour Island Acq. (CIK 0002131072)2026-11-10未进日历 / S-1/A800.00 万单位 / 10.00美元0.45美元 (4.5%) / 9.55美元总额 8,000 万 / 净募 7,640 万

以已定价新股 TRXB 为例:/stable/ipos-calendar 显示发行 8,333,334 股、dealSize 为 116,666,676 美元;同步查 /stable/ipos-prospectus 的 424B4 终稿,pricePublicPerShare = 14.00 美元(8,333,334 × 14.00 = 116,666,676 美元),扣减 7.0% 承销佣金(0.98 美元/股)后 proceedsBeforeExpensesPerShare = 13.02 美元(总额约 1.085 亿美元)。


如何用 Python 自动生成“持仓股财报、除息与拆股事件预警清单”?

以下脚本一次性拉取 /stable/earnings-calendar(开启 includeReportTimes=true)、/stable/dividends-calendar 与 /stable/splits-calendar 三个端点,内置非列表响应异常拦截、4,000 行触顶告警以及 splitType 优先的正反向拆合股识别:

import os
import requests

API_KEY = os.environ["FMP_KEY"]
BASE_URL = "https://quote-fmp.com/stable"


def fetch_json(endpoint: str, params: dict) -> list:
    resp = requests.get(f"{BASE_URL}/{endpoint}", params={**params, "apikey": API_KEY}, timeout=15)
    resp.raise_for_status()
    data = resp.json()
    if not isinstance(data, list):
        raise ValueError(f"{endpoint} 返回非列表响应: {data}")
    if len(data) >= 4000:
        print(f"[告警] {endpoint} 返回 {len(data)} 行已触及端点上限,请缩短日期窗口防截断")
    return data


def build_portfolio_event_radar(watchlist: set[str], start_date: str, end_date: str) -> list[dict]:
    events = []
    for r in fetch_json("earnings-calendar", {"from": start_date, "to": end_date, "includeReportTimes": "true"}):
        if r.get("symbol") in watchlist:
            slot = {"bmo": "盘前(BMO)", "amc": "盘后(AMC)"}.get(r.get("time") or "", "时段未定")
            status = "已确认" if r.get("confirmed") else "预估排期"
            rev_s = f"{r['revenueEstimated'] / 1e8:.2f}亿美元" if r.get("revenueEstimated") is not None else "暂无"
            events.append({"date": r["date"], "symbol": r["symbol"], "type": "财报披露",
                           "detail": f"{r.get('fiscalYear')}财年{r.get('fiscalPeriod')} | {slot} | {status} | 预期EPS {r.get('epsEstimated')} / 预期营收 {rev_s}"})
    for r in fetch_json("dividends-calendar", {"from": start_date, "to": end_date}):
        if r.get("symbol") in watchlist:
            yld_s = f"{r['yield']:.2f}%" if r.get("yield") is not None else "暂无"
            events.append({"date": r["date"], "symbol": r["symbol"], "type": "除息派息",
                           "detail": f"每股派息 {r.get('dividend')}美元 | 登记日 {r.get('recordDate')} | 派息日 {r.get('paymentDate')} | 股息率 {yld_s}"})
    for r in fetch_json("splits-calendar", {"from": start_date, "to": end_date}):
        if r.get("symbol") in watchlist:
            num, den, stype = r.get("numerator") or 0, r.get("denominator") or 1, r.get("splitType")
            ev_type = ("正向拆股" if num > den else "反向合股") if stype == "stock-split" else f"公司行动({stype})"
            act_desc = f"{den}股拆{num}股" if num > den else f"{den}股合{num}股"
            events.append({"date": r["date"], "symbol": r["symbol"], "type": ev_type,
                           "detail": f"折算比例 {num}:{den} ({act_desc},价格除权乘数 {den}/{num}) | 原始类型 {stype}"})
    return sorted(events, key=lambda x: (x["date"], x["symbol"], x["type"]))


if __name__ == "__main__":
    PORTFOLIO = {"NVDA", "LLY", "BITO", "SNDK"}
    radar = build_portfolio_event_radar(PORTFOLIO, "2026-11-13", "2026-11-20")
    print(f"=== 持仓池 8 天市场事件预警清单 (2026-11-13 至 2026-11-20,共命中 {len(radar)} 起事件) ===")
    for item in radar:
        print(f"[{item['date']}] {item['symbol']:<5} | {item['type']} | {item['detail']}")

在生产网关实测运行上述脚本,输出的 4 类代表性事件如下:

=== 持仓池 8 天市场事件预警清单 (2026-11-13 至 2026-11-20,共命中 4 起事件) ===
[2026-11-13] LLY   | 除息派息 | 每股派息 1.73美元 | 登记日 2026-11-13 | 派息日 2026-12-10 | 股息率 0.48%
[2026-11-17] NVDA  | 财报披露 | 2027财年Q3 | 盘后(AMC) | 已确认 | 预期EPS 2.47 / 预期营收 1088.39亿美元
[2026-11-19] BITO  | 反向合股 | 折算比例 1:2 (2股合1股,价格除权乘数 2/1) | 原始类型 stock-split
[2026-11-20] SNDK  | 正向拆股 | 折算比例 8:1 (1股拆8股,价格除权乘数 1/8) | 原始类型 stock-split

常见问题解答(FAQ)

1. 为什么在 /stable/dividends-calendar 中看到好市多(COST)在 2026-11-24 的每股派息高达 30 美元,且 frequency 标为 Monthly?

这是因为分红日历同时收录常规派息与特别分红。回溯 /stable/dividends?symbol=COST 历史序列可见:好市多 2026-05-01、07-24 与 10-30 除息的常规季息均为 1.47 美元/股(frequency: "Quarterly",yield 约 0.56%);而 25 天后的 2026-11-24 除息 30.00 美元/股属一次性特别分红,上游将其标为 "Monthly" 并将滚动 yield 推高至 3.2695%(约常规季度的 5.8 倍)。常态化股息率选股应结合近 4 季中位数派息额剔除特别分红尖峰。

2. 财报日历中的 epsEstimated / epsActual 和 revenueEstimated / revenueActual 与正式利润表中的哪个字段对齐?

epsEstimated 与 epsActual 对齐市场一致预期可比口径下的稀释每股收益(通常为 Non-GAAP 调整口径),而 revenueEstimated 与 revenueActual 对齐当季营业总收入(revenue)。如英伟达(NVDA)2026-08-26 披露的 FY27 Q2(期末 2026-07-26),/stable/earnings 返回 epsActual = 2.22 美元、revenueActual = 96,221,000,000 美元;同步查 Income Statement(利润表接口,/stable/income-statement?symbol=NVDA&period=quarter)可见同季 US GAAP 稀释 epsDiluted = 2.46 美元(基本 eps = 2.47 美元),法定总营收 revenue 同为 96,221,000,000 美元。如需接入上述接口,可前往 快速接入指南 免费申领 Ultimate 全接口试用密钥。

登录后可领取FMP Ultimate档15天试用 Key,覆盖全量接口。免费试用 15 天 →