復權因子
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 | 每股現金分紅(按報告幣種)。服務端 dividend_amount = '每 N 股派 X 元' 形式(N=dividend_base,X 放大 1e5),換算為每股 = amount/base/1e5。HK 通常 base=1,A 股 base=10。例: 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
}
]
}
}