美股 现金分红(已弃用) · REST 接口
分红。获取指定标的的现金分红历史记录,包括宣告日、除息日、股权登记日与派息日,以及派息金额与分红频率。
GET /v3/reference/dividends上游时效说明
每日更新
上游历史范围
数据可追溯至 2000 年 1 月 15 日
适用场景
- 收益分析、总回报计算、分红策略、税务规划。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ticker | string | No | 指定区分大小写的标的代码。例如 AAPL 代表苹果公司。 |
ex_dividend_date | string | No | 按除息日查询,格式为 YYYY-MM-DD。 |
record_date | string | No | 按股权登记日查询,格式为 YYYY-MM-DD。 |
declaration_date | string | No | 按宣告日查询,格式为 YYYY-MM-DD。 |
pay_date | string | No | 按派息日查询,格式为 YYYY-MM-DD。 |
frequency | integer | No | 按每年派息次数查询。可选值为 0(一次性)、1(每年一次)、2(每半年一次)、4(每季度一次)、12(每月一次)、24(每月两次)、52(每周一次)。 |
cash_amount | number | No | 按分红的现金金额查询。 |
dividend_type | string | No | 按分红类型查询。已支付和/或预期按固定时间表支付的股息记为 CD。已支付且发生频率低或不寻常、未来预计不会再发生的特别现金股息记为 SC。 |
ticker.gte | string | No | 按 ticker 范围筛选。 |
ticker.gt | string | No | 按 ticker 范围筛选。 |
ticker.lte | string | No | 按 ticker 范围筛选。 |
ticker.lt | string | No | 按 ticker 范围筛选。 |
ex_dividend_date.gte | string | No | 按 ex_dividend_date 范围筛选。 |
ex_dividend_date.gt | string | No | 按 ex_dividend_date 范围筛选。 |
ex_dividend_date.lte | string | No | 按 ex_dividend_date 范围筛选。 |
ex_dividend_date.lt | string | No | 按 ex_dividend_date 范围筛选。 |
record_date.gte | string | No | 按 record_date 范围筛选。 |
record_date.gt | string | No | 按 record_date 范围筛选。 |
record_date.lte | string | No | 按 record_date 范围筛选。 |
record_date.lt | string | No | 按 record_date 范围筛选。 |
declaration_date.gte | string | No | 按 declaration_date 范围筛选。 |
declaration_date.gt | string | No | 按 declaration_date 范围筛选。 |
declaration_date.lte | string | No | 按 declaration_date 范围筛选。 |
declaration_date.lt | string | No | 按 declaration_date 范围筛选。 |
pay_date.gte | string | No | 按 pay_date 范围筛选。 |
pay_date.gt | string | No | 按 pay_date 范围筛选。 |
pay_date.lte | string | No | 按 pay_date 范围筛选。 |
pay_date.lt | string | No | 按 pay_date 范围筛选。 |
cash_amount.gte | number | No | 按 cash_amount 范围筛选。 |
cash_amount.gt | number | No | 按 cash_amount 范围筛选。 |
cash_amount.lte | number | No | 按 cash_amount 范围筛选。 |
cash_amount.lt | number | No | 按 cash_amount 范围筛选。 |
order | string | No | 按 sort 字段对结果排序。 |
limit | integer | No | 限制返回结果数量,默认 10,最大 1000。 |
sort | string | No | 用于排序的字段。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 包含所请求数据的数组。 |
results[].cash_amount | number | 每股分得的现金股息金额。 |
results[].currency | string | 股息支付的货币。 |
results[].declaration_date | string | 股息公告日期。 |
results[].dividend_type | enum: CD, SC, LT, ST | 分红类型。已支付和/或预期按固定时间表支付的股息记为 CD。已支付且发生频率低或不寻常、未来预计不会再发生的特别现金股息记为 SC。长期与短期资本利得分配分别记为 LT 与 ST。 |
results[].ex_dividend_date | string | 股票首次不含股息进行交易的日期,由交易所确定。 |
results[].frequency | integer | 每年派息次数。可选值为 0(一次性)、1(每年一次)、2(每半年一次)、4(每季度一次)、12(每月一次)、24(每月两次)、52(每周一次)。 |
results[].id | string | 该笔分红的唯一标识。 |
results[].pay_date | string | 股息派发日期。 |
results[].record_date | string | 为获得股息必须持有股票的日期(股权登记日),由公司设定。 |
results[].ticker | string | 分红的股票代码。 |
status | string | 本次请求响应的状态。 |
原文:Massive 文档 ↗