Dividends Company公司分红派息

该接口返回指定股票自上市以来的完整历史分红派息序列与已宣告的未来派息计划。逐条记录除权除息日、股权登记日、实际派息日、宣告日、原始每股分红与拆股调整后分红、股息率及派息频率,是红利策略与现金流复权核算的核心数据源。

GEThttps://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 个参数
参数类型要求示例说明
symbolstring必填AAPL证券代码,例如 AAPL 或 MSFT(美股直传代码如 AAPL;港股/英股/A股须带交易所后缀,如 0700.HK、600519.SS)
limitnumber可选100返回结果条数上限,用于控制单次响应大小。

调用代码示例

Python 关键代码

公司分红派息路径为 /stable/dividends(必填 symbol),响应 JSON 展开 recordDate(登记日)、paymentDate(派息日)、declarationDate(宣告日) 共 9 列。

Python(核心参数与字段清洗逻辑)
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:空列表防守与 recordDate(登记日)提取

调用 /stable/dividends 拉取公司分红派息(必填 symbol)时,若条件未命中会返回 [];读取 recordDate(2026-05-11)与 paymentDate 前须先判断 not df.empty。

落库主键与口径对接 /stable/dividends:以 (symbol, date) 防重并提取 adjDividend(复权每股股息)

/stable/dividends 的首条样本含 adjDividend=0.27;日常增量任务按 (symbol, date) 合并即可保持本地库与上游一致。

返回数据

9 个字段

本接口示例响应共包含 9 个字段(数值型 3 个,文本/日期/布尔型 6 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。

字段类型示例值说明
symbolstring"AAPL"证券代码
datestring"2026-05-11"日期
recordDatestring"2026-05-11"登记日
paymentDatestring"2026-05-14"派息日
declarationDatestring"2026-04-30"宣告日
adjDividendnumber0.27复权每股股息
dividendnumber0.27每股股息
yieldnumber0.3587535875358754股息率
frequencystring"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按自定义起止日期区间返回全市场即将到来或历史已发生的股票分红派息事件日程表

Calendar(市场日历)全部接口目录 →

需要稳定访问 公司分红派息 数据?注册即可获取专属 API Key,免费体验全部接口。
免费试用 1 个月