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.moomoo.com/api/v1.0/quote/HK.00700/corporate-actions/splits" | jq

Response Fields

FieldTypeDescription
split_list[].dir_deci_pub_dateintBoard resolution announcement date (second-level timestamp).
split_list[].dir_deci_pub_date_strstringBoard resolution announcement date (YYYY-MM-DD).
split_list[].reform_typestringReform type: SPLIT / CONSOLIDATION / CONSOLIDATION_THEN_SPLIT / SPLIT_THEN_CONSOLIDATION.
split_list[].ratestringSplit/consolidation ratio x->y, e.g. 1→5.
split_list[].ex_dateintEx-date effective date (second-level timestamp).
split_list[].ex_date_strstringEx-date effective date (YYYY-MM-DD).
split_list[].sm_deci_dateintShareholders' meeting resolution date.
split_list[].sm_deci_date_strstringShareholders' meeting resolution date.
split_list[].scheme_statementstringScheme description text.
split_list[].new_par_valuefloatNew par value (report currency).
split_list[].temp_share_codestringTemporary share code.
split_list[].temp_share_abbr_namestringTemporary share abbreviated name.
split_list[].new_trade_unitintNew board lot size.
split_list[].shares_after_effectfloatTotal shares after effective.

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
0Success (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_errorGateway internal 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": 0.00002,
        "temp_share_code": "02988",
        "temp_share_abbr_name": "Tencent",
        "new_trade_unit": 100,
        "shares_after_effect": 9319999970
      }
    ]
  }
}