复权因子
GET/v1/quote/{symbol}/corporate-actions/rehab查询指定标的的除权除息历史与复权因子。返回每一次除权除息事件的发生日期、事件类型组合（拆股 / 合股 / 送股 / 转股 / 配股 / 增发 / 派息 / 特别派息 / 分拆）、以及对应的前复权 / 后复权因子（含累积因子）。可用于 K 线复权、分红派息回溯、公司行动时间线分析。
请求参数
| 参数 | 类型 | 位置 | 必填 | 默认 | 说明 |
|---|---|---|---|---|---|
symbol | string | 路径 | 是 | - | 标的代码，形如 HK.00700 / US.AAPL |
divi_mode | string | 查询 | 否 | include_divi | 复权因子的分红派息处理模式，详见命名词典 > divi_mode |
请求示例
bash
curl -s "$ip/v1/quote/HK.00700/corporate-actions/rehab" | jq
curl -s "$ip/v1/quote/US.AAPL/corporate-actions/rehab?divi_mode=exclude_divi" | jq
curl -s "$ip/v1/quote/SH.600036/corporate-actions/rehab" | jq响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
rehabs | array | 复权事件列表，按 ex_div_date 升序 |
rehabs[].ex_div_date | string | 除权除息日，格式 YYYY-MM-DD |
rehabs[].action_types | array<string> | 该日发生的事件类型集合，详见命名词典 > action_type |
rehabs[].desc_sc | string | 事件描述（简体中文） |
rehabs[].desc_tc | string | 事件描述（繁体中文） |
rehabs[].desc_en | string | 事件描述（英文，部分事件不提供） |
rehabs[].forward_adj_factorA | number | 当日前复权因子 A（高精度，已按 1e-9 缩放，可直接使用） |
rehabs[].forward_adj_factorB | number | 当日前复权因子 B |
rehabs[].backward_adj_factorA | number | 当日后复权因子 A |
rehabs[].backward_adj_factorB | number | 当日后复权因子 B |
rehabs[].cum_forward_adj_factorA | number | 累积前复权因子 A（自上市起累积至该事件） |
rehabs[].cum_forward_adj_factorB | number | 累积前复权因子 B |
rehabs[].cum_backward_adj_factorA | number | 累积后复权因子 A |
rehabs[].cum_backward_adj_factorB | number | 累积后复权因子 B |
rehabs[].split_ratio | number | 拆/合股比例：<1 拆股（如 0.25 表示 1 拆 4），>1 合股，=1 表示等比 |
rehabs[].join_ratio | number | 合股比例（与 SPLIT/JOIN 类型配合） |
rehabs[].bonus_ratio | number | 送股比例（每基数股送 N 股） |
rehabs[].bonus_base | number | 送股的基数 |
rehabs[].transfer_ratio | number | 转股比例 |
rehabs[].transfer_base | number | 转股的基数 |
rehabs[].transfer_ert | number | 转股事件标识值 |
rehabs[].allotment_ratio | number | 配股比例 |
rehabs[].allotment_price | number | 配股价格 |
rehabs[].add_base | number | 增发的基数 |
rehabs[].add_ert | number | 增发事件标识值 |
rehabs[].dividend | number | 派息金额（每股，原币种） |
rehabs[].special_dividend | number | 特别派息金额（每股，原币种） |
rehabs[].special_dividend_base | number | 特别派息的基数 |
rehabs[].spin_off_ratio | number | 分拆比例 |
限制范围
- 市场：HK / US / SH / SZ / CA / AU / JP / SG 全市场支持。
- 品类：仅正股有除权除息历史；指数、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": 0,
"transfer_ratio": 0,
"transfer_base": 0,
"allotment_ratio": 0,
"allotment_price": 0,
"dividend": 0.07,
"special_dividend": 0,
"spin_off_ratio": 0
}
]
}
}