Dividends Company公司分红派息
该接口返回指定股票自上市以来的完整历史分红派息序列与已宣告的未来派息计划。逐条记录除权除息日、股权登记日、实际派息日、宣告日、原始每股分红与拆股调整后分红、股息率及派息频率,是红利策略与现金流复权核算的核心数据源。
https://quote-fmp.com/stable/dividends?symbol=AAPL数据更新周期
1-2 Hours
接口说明
- 红利因子构建与股息增长筛选:美股价值投资高度重视“股息贵族”(连续数十年稳定增长派息的企业)。通过拉取个股完整历史派息序列,结合经拆股调整后的可比每股分红金额,可精确计算过去 5 至 10 年的股息复合增长率(CAGR)与派息连续性。
- 除息四个关键日节点与事件套利研究:接口完整区分宣告日、除权除息日、股权登记日与现金到账派息日。量化团队可围绕宣告日研究超预期增派股息的事件收益,或围绕除息日统计历史填权速度与税收套利窗口。
- 明确派息频率与前瞻股息率测算:美股上市公司派息节奏涵盖季付、月付(如部分 REITs)、半年付及年付,且偶有特别股息干扰。接口直接标明派息频率属性与当期股息率,协助投研系统准确推算未来 12 个月的预期现金流入。
- 上下游关联接口:Stock Split Details(公司拆合股明细) · Stock Splits Calendar(拆合股日历) · Income Statement(利润表) · Stock Price and Volume Data(日线完整行情)
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS) |
limit | number | 可选 | 100 | 返回结果条数上限,用于控制单次响应大小。 |
调用代码示例
Python 关键代码公司分红派息路径为 /stable/dividends(必填 symbol),响应 JSON 展开 recordDate(登记日)、paymentDate(派息日)、declarationDate(宣告日) 共 9 列。
resp = requests.get(
"https://quote-fmp.com/stable/dividends",
params={"symbol": "AAPL", "limit": 100, "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)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入 symbol=AAPL 请求公司分红派息 | symbol=AAPL | 调用 /stable/dividends 拉取 AAPL 的公司分红派息,输出 recordDate、paymentDate、declarationDate 等 9 项标准化属性。 |
| 设置返回条数上限(limit=100)回溯 AAPL 公司分红派息 | symbol=AAPL&limit=100 | 通过条数上限参数请求 /stable/dividends,单次拉回 AAPL 更长历史周期的 recordDate、paymentDate、declarationDate。 |
| 跨市场检索 0700.HK 的公司分红派息数据 | symbol=0700.HK | 通过 symbol=0700.HK 请求 /stable/dividends,实现公司分红派息在港股市场的同口径采集(含 recordDate、paymentDate、declarationDate)。 |
调用 /stable/dividends 拉取公司分红派息(必填 symbol)时,若条件未命中会返回 [];读取 recordDate(2026-05-11)与 paymentDate 前须先判断 not df.empty。
/stable/dividends 的首条样本含 adjDividend=0.27;日常增量任务按 (symbol, date) 合并即可保持本地库与上游一致。
返回数据
9 个字段本接口示例响应共包含 9 个字段(数值型 3 个,文本/日期/布尔型 6 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
date | string | "2026-05-11" | 日期 |
recordDate | string | "2026-05-11" | 登记日 |
paymentDate | string | "2026-05-14" | 派息日 |
declarationDate | string | "2026-04-30" | 宣告日 |
adjDividend | number | 0.27 | 复权每股股息 |
dividend | number | 0.27 | 每股股息 |
yield | number | 0.3587535875358754 | 股息率 |
frequency | string | "Quarterly" | 派息频率 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "AAPL",
"date": "2026-05-11",
"recordDate": "2026-05-11",
"paymentDate": "2026-05-14",
"declarationDate": "2026-04-30",
"adjDividend": 0.27,
"dividend": 0.27,
"yield": 0.3587535875358754,
"frequency": "Quarterly"
}
]常见问题解答(FAQ)
2 个问题公司分红派息(/stable/dividends)产出的 recordDate 等字段,与 分红派息日历 的返回内容有何侧重?
公司分红派息(端点 /stable/dividends,必填 symbol)返回 recordDate(登记日)及 paymentDate(2026-05-14)共 9 列;若业务需要 Dividends Calendar(分红派息日历),可改调 /stable/dividends-calendar(无必填参数)。
工程团队在封装 /stable/dividends(公司分红派息)客户端时,应采用怎样的拉取逻辑?
标准流程是在 /stable/dividends 中显式调大 limit 参数(如 limit=100)单次拉取多期记录;在拿到 公司分红派息 的 recordDate 与 paymentDate 后,及时释放内存中的原始文本流。
同模块相关接口对比
Dividends本接口路径 /stable/dividends,必填参数 symbol。 同一模块「Dividends」下共 2 个接口,下表列出其余 1 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 分红派息日历Dividends Calendar | /stable/dividends-calendar | 按自定义起止日期区间返回全市场即将到来或历史已发生的股票分红派息事件日程表 |