REST 接口 · 文档目录

美股 现金分红(已弃用) · REST 接口

分红。获取指定标的的现金分红历史记录,包括宣告日、除息日、股权登记日与派息日,以及派息金额与分红频率。

GET /v3/reference/dividends
上游时效说明

每日更新

上游历史范围

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

适用场景

  • 收益分析、总回报计算、分红策略、税务规划。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
tickerstringNo指定区分大小写的标的代码。例如 AAPL 代表苹果公司。
ex_dividend_datestringNo按除息日查询,格式为 YYYY-MM-DD。
record_datestringNo按股权登记日查询,格式为 YYYY-MM-DD。
declaration_datestringNo按宣告日查询,格式为 YYYY-MM-DD。
pay_datestringNo按派息日查询,格式为 YYYY-MM-DD。
frequencyintegerNo按每年派息次数查询。可选值为 0(一次性)、1(每年一次)、2(每半年一次)、4(每季度一次)、12(每月一次)、24(每月两次)、52(每周一次)。
cash_amountnumberNo按分红的现金金额查询。
dividend_typestringNo按分红类型查询。已支付和/或预期按固定时间表支付的股息记为 CD。已支付且发生频率低或不寻常、未来预计不会再发生的特别现金股息记为 SC。
ticker.gtestringNo按 ticker 范围筛选。
ticker.gtstringNo按 ticker 范围筛选。
ticker.ltestringNo按 ticker 范围筛选。
ticker.ltstringNo按 ticker 范围筛选。
ex_dividend_date.gtestringNo按 ex_dividend_date 范围筛选。
ex_dividend_date.gtstringNo按 ex_dividend_date 范围筛选。
ex_dividend_date.ltestringNo按 ex_dividend_date 范围筛选。
ex_dividend_date.ltstringNo按 ex_dividend_date 范围筛选。
record_date.gtestringNo按 record_date 范围筛选。
record_date.gtstringNo按 record_date 范围筛选。
record_date.ltestringNo按 record_date 范围筛选。
record_date.ltstringNo按 record_date 范围筛选。
declaration_date.gtestringNo按 declaration_date 范围筛选。
declaration_date.gtstringNo按 declaration_date 范围筛选。
declaration_date.ltestringNo按 declaration_date 范围筛选。
declaration_date.ltstringNo按 declaration_date 范围筛选。
pay_date.gtestringNo按 pay_date 范围筛选。
pay_date.gtstringNo按 pay_date 范围筛选。
pay_date.ltestringNo按 pay_date 范围筛选。
pay_date.ltstringNo按 pay_date 范围筛选。
cash_amount.gtenumberNo按 cash_amount 范围筛选。
cash_amount.gtnumberNo按 cash_amount 范围筛选。
cash_amount.ltenumberNo按 cash_amount 范围筛选。
cash_amount.ltnumberNo按 cash_amount 范围筛选。
orderstringNo按 sort 字段对结果排序。
limitintegerNo限制返回结果数量,默认 10,最大 1000。
sortstringNo用于排序的字段。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]包含所请求数据的数组。
results[].cash_amountnumber每股分得的现金股息金额。
results[].currencystring股息支付的货币。
results[].declaration_datestring股息公告日期。
results[].dividend_typeenum: CD, SC, LT, ST分红类型。已支付和/或预期按固定时间表支付的股息记为 CD。已支付且发生频率低或不寻常、未来预计不会再发生的特别现金股息记为 SC。长期与短期资本利得分配分别记为 LT 与 ST。
results[].ex_dividend_datestring股票首次不含股息进行交易的日期,由交易所确定。
results[].frequencyinteger每年派息次数。可选值为 0(一次性)、1(每年一次)、2(每半年一次)、4(每季度一次)、12(每月一次)、24(每月两次)、52(每周一次)。
results[].idstring该笔分红的唯一标识。
results[].pay_datestring股息派发日期。
results[].record_datestring为获得股息必须持有股票的日期(股权登记日),由公司设定。
results[].tickerstring分红的股票代码。
statusstring本次请求响应的状态。

原文:Massive 文档 ↗