Skip to content

Stock Splits ​

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

Get detailed records of HK stock split/consolidation events (split / consolidation / consolidation-then-split / split-then-consolidation). Only HK market is supported.

Parameters ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol code (HK stocks only have data), e.g. HK.00700.

Request Example ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/corporate-actions/splits" | jq

Response Fields ​

NameTypeDescription
dataobject
data.split_listobject[]Split/consolidation event list (HK). Empty array [] when there are no events
data.split_list[].dir_deci_pub_dateintBoard resolution announcement date, second-level timestamp, e.g. 1399996800
data.split_list[].dir_deci_pub_date_strstringBoard resolution announcement date string (market timezone), format yyyy-MM-dd, e.g. 2014-05-13
data.split_list[].reform_typestringReorganization type enum. SPLIT / CONSOLIDATION (10) / CONSOLIDATION_THEN_SPLIT (20) / SPLIT_THEN_CONSOLIDATION (25), e.g. 'SPLIT'
data.split_list[].ratestringSplit/consolidation ratio, format 'x->y'. Single segment for SPLIT/CONSOLIDATION (e.g. '1->5' = 1 share split into 5); two semicolon-separated segments for CONSOLIDATION_THEN_SPLIT / SPLIT_THEN_CONSOLIDATION ('consolidation;split' resp. 'split;consolidation'), e.g. '10->1;1->5'
data.split_list[].ex_dateintSplit/consolidation effective date, second-level timestamp, e.g. 1400112000
data.split_list[].ex_date_strstringSplit/consolidation effective date string (market timezone), format yyyy-MM-dd, e.g. 2014-05-15
data.split_list[].sm_deci_dateintShareholders' meeting resolution date, second-level timestamp
data.split_list[].sm_deci_date_strstringShareholders' meeting resolution date string (market timezone), format yyyy-MM-dd
data.split_list[].temp_trade_begin_dateintTemporary code trading start date, second-level timestamp
data.split_list[].temp_trade_begin_date_strstringTemporary code trading start date string, format yyyy-MM-dd
data.split_list[].simul_trade_begin_dateintOld/new parallel trading start date, second-level timestamp
data.split_list[].simul_trade_begin_date_strstringOld/new parallel trading start date string, format yyyy-MM-dd
data.split_list[].simul_trade_end_dateintOld/new parallel trading end date, second-level timestamp
data.split_list[].simul_trade_end_date_strstringOld/new parallel trading end date string, format yyyy-MM-dd
data.split_list[].event_statusstringEvent status text, e.g. 'Plan Implementation'
data.split_list[].scheme_statementstringScheme statement (free text describing the split/consolidation plan)
data.split_list[].new_par_valuenumberNew par value (in reporting currency). e.g. 0.00002 (HKD)
data.split_list[].temp_share_codestringTemporary stock code (without market prefix), e.g. '02988'
data.split_list[].temp_share_abbr_namestringTemporary stock short name, e.g. 'Tencent'
data.split_list[].new_trade_unitintNew lot size, e.g. 100
data.split_list[].shares_after_effectnumberTotal shares after effective date (in shares). e.g. 9319999970
paginationobject
pagination.has_morebool
pagination.next_keystring

Supported Markets ​

  • Supported markets: HK only. Other markets return empty split_list.
  • Categories: Primarily HK common stocks; symbols with no split/consolidation events return empty array.

Error Codes ​

ret_codeerror.codeTrigger ConditionSuggested Action
0—Success (including empty list when no events)—
-3invalid_parameterInvalid symbol formatCorrect symbol and retry
-7invalid_symbolCode cannot be resolved to a securityVerify code validity via search API
-2 / -4 / -6internal_errorService errorRetry later, report if persistent

Response Example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "split_list": [
      {
        "dir_deci_pub_date": 1395158400,
        "dir_deci_pub_date_str": "2014-03-19",
        "reform_type": "SPLIT",
        "rate": "1→5",
        "ex_date": 1400083200,
        "ex_date_str": "2014-05-15",
        "sm_deci_date": 1399996800,
        "sm_deci_date_str": "2014-05-14",
        "event_status": "Plan Implementation",
        "scheme_statement": "Each of the existing issued and unissued shares with a par value of HK$0.0001 per share shall be split into five (5) subdivided shares, each with a par value of HK$0.00002; the trading lot size shall remain 100 subdivided shares.",
        "new_par_value": 2e-05,
        "temp_share_code": "02988",
        "temp_share_abbr_name": "Tencent",
        "new_trade_unit": 100,
        "shares_after_effect": 9319999970
      }
    ]
  }
}