美股现金分红 · REST 接口

分红（含复权因子）。获取指定标的的现金分红历史记录，包括宣告日、除息日、股权登记日与派息日，以及派息金额与用于还原历史价格的复权因子，便于在收益计算中计入分红收入并支持税务申报。

GET /stocks/v1/dividends

上游时效说明

每日更新

上游历史范围

数据可追溯至 2000 年 1 月 15 日

适用场景

收益分析、总回报计算、分红策略、税务规划。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`ticker`	string	No	派发该笔分红公司的股票代码
`ticker.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`ticker.gt`	string	No	筛选大于该值。
`ticker.gte`	string	No	筛选大于或等于该值。
`ticker.lt`	string	No	筛选小于该值。
`ticker.lte`	string	No	筛选小于或等于该值。
`ex_dividend_date`	string	No	该股票开始不含分红价值交易的日期。值格式须为 yyyy-mm-dd。
`ex_dividend_date.gt`	string	No	筛选大于该值。值格式须为 yyyy-mm-dd。
`ex_dividend_date.gte`	string	No	筛选大于或等于该值。值格式须为 yyyy-mm-dd。
`ex_dividend_date.lt`	string	No	筛选小于该值。值格式须为 yyyy-mm-dd。
`ex_dividend_date.lte`	string	No	筛选小于或等于该值。值格式须为 yyyy-mm-dd。
`frequency`	integer	No	该分红预计每年发生的次数。值为 0 表示分配非定期或不规则（例如特别分红、补充分红或一次性分红）。其他可能取值包括 1（每年）、2（每半年）、3（每四个月）、4（每季度）、12（每月）、24（每月两次）、52（每周）、104（每周两次）、365（每日），具体取决于发行方公布或推定的派息节奏。值必须为整数。
`frequency.gt`	integer	No	筛选大于该值。值必须为整数。
`frequency.gte`	integer	No	筛选大于或等于该值。值必须为整数。
`frequency.lt`	integer	No	筛选小于该值。值必须为整数。
`frequency.lte`	integer	No	筛选小于或等于该值。值必须为整数。
`distribution_type`	string	No	描述该笔分红派息重复规律的分类：recurring（按固定周期派发）、special（一次性或纪念性）、supplemental（固定周期之外的额外派发）、irregular（不可预测或非经常性）、unknown（无法根据现有数据分类）
`distribution_type.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 5000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 ticker，排序方向默认为 asc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].cash_amount`	number	按指定货币计价的原每股分红金额。
`results[].currency`	string	分红支付的货币代码（例如 USD、CAD）。
`results[].declaration_date`	string	公司正式宣告分红的日期。
`results[].distribution_type`	string	描述该笔分红派息重复规律的分类：recurring（按固定周期派发）、special（一次性或纪念性）、supplemental（固定周期之外的额外派发）、irregular（不可预测或非经常性）、unknown（无法根据现有数据分类）
`results[].ex_dividend_date`	string	该股票开始不含分红价值交易的日期。
`results[].frequency`	integer	该分红预计每年发生的次数。值为 0 表示分配非定期或不规则（例如特别分红、补充分红或一次性分红）。其他可能取值包括 1（每年）、2（每半年）、3（每四个月）、4（每季度）、12（每月）、24（每月两次）、52（每周）、104（每周两次）、365（每日），具体取决于发行方公布或推定的派息节奏。
`results[].historical_adjustment_factor`	number	用于抵消分红对历史价格影响的累计复权因子。按分红调整历史价格的算法：对于日期 D 的价格，找到 ex_dividend_date 晚于 D 的第一笔分红，将该价格乘以此笔分红的 historical_adjustment_factor。
`results[].id`	string	每笔分红记录的唯一标识。
`results[].pay_date`	string	向股东派发分红的日期。
`results[].record_date`	string	股东须在册方有资格获得分红的日期（股权登记日）。
`results[].split_adjusted_cash_amount`	number	按分红派发之后发生的拆合股调整后的分红金额，以当前股本口径表示。
`results[].ticker`	string	派发该笔分红公司的股票代码
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "request_id": 1,
  "results": [
    {
      "cash_amount": 0.26,
      "currency": "USD",
      "declaration_date": "2025-07-31",
      "distribution_type": "recurring",
      "ex_dividend_date": "2025-08-11",
      "frequency": 4,
      "historical_adjustment_factor": 0.997899,
      "id": "Ed2c9da60abda1e3f0e99a43f6465863c137b671e1f5cd3f833d1fcb4f4eb27fe",
      "pay_date": "2025-08-14",
      "record_date": "2025-08-11",
      "split_adjusted_cash_amount": 0.26,
      "ticker": "AAPL"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

美股 现金分红 · REST 接口

适用场景

查询参数

响应字段

响应示例

美股现金分红 · REST 接口