复权因子
GET/api/v1.0/quote/{symbol}/corporate-actions/rehab查询指定标的的除权除息历史与复权因子。返回每一次除权除息事件的发生日期、事件类型组合(拆股 / 合股 / 送股 / 转股 / 配股 / 增发 / 派息 / 特别派息 / 分拆)、以及对应的前复权 / 后复权因子(含累积因子)。可用于 K 线复权、分红派息回溯、公司行动时间线分析。
请求参数
| 参数 | 类型 | 位置 | 必填 | 默认 | 说明 |
|---|---|---|---|---|---|
symbol | string | 路径 | 是 | - | 标的代码,形如 HK.00700 / US.AAPL |
divi_mode | string | 查询 | 否 | 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响应字段
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.rehabs | object[] | |
data.rehabs[].ex_div_date | string | 除权除息日,格式 yyyy-MM-dd(按市场当地日历,无时区换算)。例: '2005-04-19' |
data.rehabs[].action_types | string[] | 本条事件包含的公司行动类型(位掩码 ert_flag 解出的字符串数组,可叠加,如 ['SPLIT','DIVIDEND'])。取值见枚举 SPLIT/JOIN/BONUS_STK/INTOSHARES/ALLOT/ADD/DIVIDEND/SPECIALDIVIDEND/SPINOFF |
data.rehabs[].desc_sc | string | 事件简体中文描述。例: '每股派息0.07港元' |
data.rehabs[].desc_tc | string | 事件繁体中文描述 |
data.rehabs[].desc_en | string | 事件英文描述 |
data.rehabs[].forward_adj_factorA | number | 前复权因子 A(乘法因子,单事件值)。 |
data.rehabs[].forward_adj_factorB | number | 前复权因子 B(加法因子,单事件值) |
data.rehabs[].backward_adj_factorA | number | 后复权因子 A(乘法因子,单事件值) |
data.rehabs[].backward_adj_factorB | number | 后复权因子 B(加法因子,单事件值) |
data.rehabs[].cum_forward_adj_factorA | number | 前复权因子 A 累积值(自历史首条事件起的运行乘积)。客户端复权可直接用此累积值 |
data.rehabs[].cum_forward_adj_factorB | number | 前复权因子 B 累积值 |
data.rehabs[].cum_backward_adj_factorA | number | 后复权因子 A 累积值 |
data.rehabs[].cum_backward_adj_factorB | number | 后复权因子 B 累积值 |
data.rehabs[].split_base | int | 拆股前基数(int),整数,无放大倍数 |
data.rehabs[].split_ert | int | 拆股后份数(int),整数,无放大倍数 |
data.rehabs[].join_base | string | 合股前基数(HK 老数据可能为 ×1e5 放大值) |
data.rehabs[].join_ert | string | 合股后份数(HK 老数据可能为 ×1e5 放大值) |
data.rehabs[].split_ratio | number | 拆/合股比例(split_base/split_ert,无则取 join_base/join_ert)。例: 拆股 1→5 时 0.2 |
data.rehabs[].bonus_base | int | 送股前基数(int) |
data.rehabs[].bonus_ert | int | 送股后份数(int) |
data.rehabs[].per_share_div_ratio | number | 每股送股比例(bonus_stk_base/bonus_stk_ert) |
data.rehabs[].transfer_base | int | 转赠前基数(int) |
data.rehabs[].transfer_ert | int | 转赠后份数(int) |
data.rehabs[].per_share_trans_ratio | number | 每股转赠比例(into_shr_base/into_ert) |
data.rehabs[].allot_base | int | 配股前基数(int) |
data.rehabs[].allot_ert | int | 配股后份数(int) |
data.rehabs[].allotment_ratio | number | 配股比例(allot_base/allot_ert) |
data.rehabs[].allotment_price | number | 配股价格(按报告币种) |
data.rehabs[].add_base | int | 增发前基数(int) |
data.rehabs[].add_ert | int | 增发后份数(int) |
data.rehabs[].stk_spo_ratio | number | 增发比例(stk_add_base/stk_add_ert) |
data.rehabs[].stk_spo_price | number | 增发价格(按报告币种) |
data.rehabs[].spin_off_base | int | 分拆前基数(int) |
data.rehabs[].spin_off_ert | int | 分拆后份数(int) |
data.rehabs[].spin_off_ratio | number | 分拆比例(spin_off_base/spin_off_ert) |
data.rehabs[].per_cash_div | number | 每股现金分红(按报告币种)。返回值已按每股金额折算。例: 0.07 |
data.rehabs[].special_dividend | number | 每股特别股息(按报告币种)。同 per_cash_div 公式:amount/base/1e5 |
pagination | object | 部分接口返回分页信息 |
限制范围
- code 必须是已开通行情前缀必须落在下列 9 个市场内,否则返回
invalid_symbol:HK / US / SH / SZ / CA / AU / JP / SG / KR。 - 品类:仅正股有除权除息历史;指数、ETF、窝轮、期权、期货、债券等品类调用合法但 rehabs 一般为空数组。
- 历史范围:自标的上市以来的全部除权除息事件,无时间窗口参数。
- 数据精度:复权因子已按 1e-9 缩放,调用方可直接使用浮点数值,无需再做处理。
错误码
| ret_code | error.code | 触发条件 | 处理建议 |
|---|---|---|---|
| 0 | - | 调用成功(含 rehabs 为空数组) | 正常处理;空数组表示该标的当前无除权除息历史 |
| -3 | invalid_parameter | divi_mode 取值不在枚举集合内 | 检查参数是否为 compat / exclude_divi / include_divi 之一 |
| -7 | invalid_symbol | symbol 无法解析为有效证券 | 检查 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
}
]
}
}