Dividends Calendar分红派息日历
该接口按自定义起止日期区间返回全市场即将到来或历史已发生的股票分红派息事件日程表。作为横跨全市场的派息雷达，它汇总了各标的的除息日、登记日、派息日、每股分红金额与股息率，直接服务于红利捕获策略与组合现金流日历排期。
https://quote-fmp.com/stable/dividends-calendar数据更新周期
1-2 Hours
接口说明
- 全市场除息扫描与红利捕获排期：针对围绕除息日前后开展波段交易或红利捕获的量化策略，该接口支持按未来日期区间一次性拉出全市场所有即将除息的股票清单、具体除息日期及当期股息率，无需逐只股票轮询。
- 投资组合现金流预测与股息再投资调度：资管机构的组合管理系统（PMS）与托管清算团队可通过该日历提前锁定未来数周内持仓股票的股权登记日与现金派息日，精准预测每日账户新增现金头寸，提前规划股息再投资（DRIP）或流动性调拨。
- 衍生品定价与股指基差除息日历基准：在期权定价（尤其是美式认购期权提前行权判定）与股指期货基差监控中，成分股的未来除息日与派息金额是关键输入变量。通过定时同步该日历，衍生品交易台可动态更新各交易日的预期除息冲击。
- 关联数据线接口：IPOs Calendar（IPO 日历） · IPOs Disclosure（IPO 申报文件） · Press Releases（公司新闻稿） · Earnings Transcript（业绩电话会纪要检索）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
from | date | 可选 | 2026-03-06 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-06-06 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
调用代码示例
Python 关键代码在 Python 中调用 分红派息日历（/stable/dividends-calendar，可选 from, to），可提取 recordDate（登记日）、paymentDate（派息日）、declarationDate（宣告日）（recordDate=2026-07-30）。
resp = requests.get(
"https://quote-fmp.com/stable/dividends-calendar",
params={"from": "2026-03-06", "to": "2026-06-06", "page": 0, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 adjDividend（复权每股股息）
df["adjDividend"] = pd.to_numeric(df["adjDividend"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入一季度起止日期提取分红派息日历列表 | from=2025-01-01&to=2025-03-31 | 请求 /stable/dividends-calendar 并指定 2025 一季度边界，一次拿齐该时段的 recordDate、paymentDate、declarationDate 等核心字段。 |
| 分段拉取 2024 下半年分红派息日历全量记录 | from=2024-07-01&to=2024-12-31 | 通过半年期滑窗参数请求 /stable/dividends-calendar，稳定拉取 2024H2 期间的 recordDate、paymentDate、declarationDate 记录。 |
使用 /stable/dividends-calendar 同步分红派息日历（可选 from, to）时，recordDate（登记日）与 paymentDate（派息日）为关键业务列；多次拉取或增量合并时请在边界处按主键去重。
对分红派息日历（/stable/dividends-calendar）执行增量 ETL 时，通过 (symbol, date) 唯一约束幂等写入，并将 adjDividend（复权每股股息）与 dividend（每股股息） 统一转为浮点列。
返回数据
9 个字段本接口示例响应共包含 9 个字段（数值型 3 个，文本/日期/布尔型 6 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "5871.TW" | 证券代码 |
date | string | "2026-07-29" | 日期 |
recordDate | string | "2026-07-30" | 登记日 |
paymentDate | string | "2026-09-01" | 派息日 |
declarationDate | string | "" | 宣告日 |
adjDividend | number | 5.8 | 复权每股股息 |
dividend | number | 5.916 | 每股股息 |
yield | number | 5.155555555555556 | 股息率 |
frequency | string | "Annual" | 派息频率 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "5871.TW",
"date": "2026-07-29",
"recordDate": "2026-07-30",
"paymentDate": "2026-09-01",
"declarationDate": "",
"adjDividend": 5.8,
"dividend": 5.916,
"yield": 5.155555555555556,
"frequency": "Annual"
}
]常见问题解答（FAQ）
2 个问题投研选型时，什么场景用分红派息日历（/stable/dividends-calendar），什么场景改用 公司分红派息？
当您需要 recordDate（登记日，如 2026-07-30）与 paymentDate（派息日）时调 分红派息日历（/stable/dividends-calendar，可选 from, to）；反之若侧重 Dividends Company（公司分红派息） 的维度，则请求 /stable/dividends（必填 symbol）。
在脚本里循环或定时请求 /stable/dividends-calendar（分红派息日历）时，有哪些调度细节要注意？
在脚本编排上，建议按日历窗口设置 from 和 to 边界调用 /stable/dividends-calendar；将每次从 /stable/dividends-calendar 拿到的 recordDate（登记日）按批次追加至本地历史表。
同模块相关接口对比
Dividends本接口路径 /stable/dividends-calendar，无必填参数。 同一模块「Dividends」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司分红派息Dividends Company | /stable/dividends | 指定股票自上市以来的完整历史分红派息序列与已宣告的未来派息计划 |