Stock Splits
GET/api/v1.0/quote/{symbol}/corporate-actions/splitsGet detailed records of HK stock split/consolidation events (split / consolidation / consolidation-then-split / split-then-consolidation). Only HK market is supported.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Symbol 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" | jqResponse Fields
| Field | Type | Description |
|---|---|---|
split_list[].dir_deci_pub_date | int | Board resolution announcement date (second-level timestamp). |
split_list[].dir_deci_pub_date_str | string | Board resolution announcement date (YYYY-MM-DD). |
split_list[].reform_type | string | Reform type: SPLIT / CONSOLIDATION / CONSOLIDATION_THEN_SPLIT / SPLIT_THEN_CONSOLIDATION. |
split_list[].rate | string | Split/consolidation ratio x->y, e.g. 1→5. |
split_list[].ex_date | int | Ex-date effective date (second-level timestamp). |
split_list[].ex_date_str | string | Ex-date effective date (YYYY-MM-DD). |
split_list[].sm_deci_date | int | Shareholders' meeting resolution date. |
split_list[].sm_deci_date_str | string | Shareholders' meeting resolution date. |
split_list[].scheme_statement | string | Scheme description text. |
split_list[].new_par_value | float | New par value (report currency). |
split_list[].temp_share_code | string | Temporary share code. |
split_list[].temp_share_abbr_name | string | Temporary share abbreviated name. |
split_list[].new_trade_unit | int | New board lot size. |
split_list[].shares_after_effect | float | Total 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_code | error.code | Trigger Condition | Suggested Action |
|---|---|---|---|
| 0 | — | Success (including empty list when no events) | — |
| -3 | invalid_parameter | Invalid symbol format | Correct symbol and retry |
| -7 | invalid_symbol | Code cannot be resolved to a security | Verify code validity via search API |
| -2 / -4 / -6 | internal_error | Gateway internal error | Retry 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
}
]
}
}