Skip to content

复权因子 ​

GET /api/v1.0/quote/{symbol}/corporate-actions/rehab

查询指定标的的除权除息历史与复权因子。返回每一次除权除息事件的发生日期、事件类型组合(拆股 / 合股 / 送股 / 转股 / 配股 / 增发 / 派息 / 特别派息 / 分拆)、以及对应的前复权 / 后复权因子(含累积因子)。可用于 K 线复权、分红派息回溯、公司行动时间线分析。

请求参数 ​

参数类型位置必填默认说明
symbolstring路径是-标的代码,形如 HK.00700 / US.AAPL
divi_modestring查询否include_divi复权因子的分红派息处理模式,详见命名词典 > divi_mode

请求示例 ​

bash
curl -s "https://webapi.futunn.com/api/v1.0/quote/HK.00700/corporate-actions/rehab" | jq
curl -s "https://webapi.futunn.com/api/v1.0/quote/US.AAPL/corporate-actions/rehab?divi_mode=exclude_divi" | jq
curl -s "https://webapi.futunn.com/api/v1.0/quote/SH.600036/corporate-actions/rehab" | jq

响应字段 ​

参数类型说明
dataobject
data.rehabsobject[]
data.rehabs[].ex_div_datestring除权除息日,格式 yyyy-MM-dd(按市场当地日历,无时区换算)。例: '2005-04-19'
data.rehabs[].action_typesstring[]本条事件包含的公司行动类型(位掩码 ert_flag 解出的字符串数组,可叠加,如 ['SPLIT','DIVIDEND'])。取值见枚举 SPLIT/JOIN/BONUS_STK/INTOSHARES/ALLOT/ADD/DIVIDEND/SPECIALDIVIDEND/SPINOFF
data.rehabs[].desc_scstring事件简体中文描述。例: '每股派息0.07港元'
data.rehabs[].desc_tcstring事件繁体中文描述
data.rehabs[].desc_enstring事件英文描述
data.rehabs[].forward_adj_factorAnumber前复权因子 A(乘法因子,单事件值)。
data.rehabs[].forward_adj_factorBnumber前复权因子 B(加法因子,单事件值)
data.rehabs[].backward_adj_factorAnumber后复权因子 A(乘法因子,单事件值)
data.rehabs[].backward_adj_factorBnumber后复权因子 B(加法因子,单事件值)
data.rehabs[].cum_forward_adj_factorAnumber前复权因子 A 累积值(自历史首条事件起的运行乘积)。客户端复权可直接用此累积值
data.rehabs[].cum_forward_adj_factorBnumber前复权因子 B 累积值
data.rehabs[].cum_backward_adj_factorAnumber后复权因子 A 累积值
data.rehabs[].cum_backward_adj_factorBnumber后复权因子 B 累积值
data.rehabs[].split_baseint拆股前基数(int),整数,无放大倍数
data.rehabs[].split_ertint拆股后份数(int),整数,无放大倍数
data.rehabs[].join_basestring合股前基数(HK 老数据可能为 ×1e5 放大值)
data.rehabs[].join_ertstring合股后份数(HK 老数据可能为 ×1e5 放大值)
data.rehabs[].split_rationumber拆/合股比例(split_base/split_ert,无则取 join_base/join_ert)。例: 拆股 1→5 时 0.2
data.rehabs[].bonus_baseint送股前基数(int)
data.rehabs[].bonus_ertint送股后份数(int)
data.rehabs[].per_share_div_rationumber每股送股比例(bonus_stk_base/bonus_stk_ert)
data.rehabs[].transfer_baseint转赠前基数(int)
data.rehabs[].transfer_ertint转赠后份数(int)
data.rehabs[].per_share_trans_rationumber每股转赠比例(into_shr_base/into_ert)
data.rehabs[].allot_baseint配股前基数(int)
data.rehabs[].allot_ertint配股后份数(int)
data.rehabs[].allotment_rationumber配股比例(allot_base/allot_ert)
data.rehabs[].allotment_pricenumber配股价格(按报告币种)
data.rehabs[].add_baseint增发前基数(int)
data.rehabs[].add_ertint增发后份数(int)
data.rehabs[].stk_spo_rationumber增发比例(stk_add_base/stk_add_ert)
data.rehabs[].stk_spo_pricenumber增发价格(按报告币种)
data.rehabs[].spin_off_baseint分拆前基数(int)
data.rehabs[].spin_off_ertint分拆后份数(int)
data.rehabs[].spin_off_rationumber分拆比例(spin_off_base/spin_off_ert)
data.rehabs[].per_cash_divnumber每股现金分红(按报告币种)。返回值已按每股金额折算。例: 0.07
data.rehabs[].special_dividendnumber每股特别股息(按报告币种)。同 per_cash_div 公式:amount/base/1e5
paginationobject部分接口返回分页信息

限制范围 ​

  • code 必须是已开通行情前缀必须落在下列 9 个市场内,否则返回 invalid_symbol:HK / US / SH / SZ / CA / AU / JP / SG / KR。
  • 品类:仅正股有除权除息历史;指数、ETF、窝轮、期权、期货、债券等品类调用合法但 rehabs 一般为空数组。
  • 历史范围:自标的上市以来的全部除权除息事件,无时间窗口参数。
  • 数据精度:复权因子已按 1e-9 缩放,调用方可直接使用浮点数值,无需再做处理。

错误码 ​

ret_codeerror.code触发条件处理建议
0-调用成功(含 rehabs 为空数组)正常处理;空数组表示该标的当前无除权除息历史
-3invalid_parameterdivi_mode 取值不在枚举集合内检查参数是否为 compat / exclude_divi / include_divi 之一
-7invalid_symbolsymbol 无法解析为有效证券检查 symbol 格式与标的存在性

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "rehabs": [
      {
        "ex_div_date": "2005-04-19",
        "action_types": [
          "DIVIDEND"
        ],
        "desc_sc": "派息 每股0.07港元",
        "forward_adj_factorA": 2.9764677429100327e-07,
        "forward_adj_factorB": -5.300133775844185,
        "backward_adj_factorA": 3359687.0061233053,
        "backward_adj_factorB": 17806790.57741896,
        "cum_forward_adj_factorA": 2.9764677429100327e-07,
        "cum_forward_adj_factorB": -5.300133775844185,
        "cum_backward_adj_factorA": 3359687.0061233053,
        "cum_backward_adj_factorB": 17806790.57741896,
        "split_ratio": 0,
        "join_ratio": 0,
        "bonus_ratio": 0,
        "bonus_base": 1,
        "transfer_ratio": 0,
        "transfer_base": 1,
        "allotment_ratio": 0,
        "allotment_price": 0,
        "dividend": 0.07,
        "special_dividend": 0,
        "spin_off_ratio": 0
      }
    ]
  }
}