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