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.futunn.com/api/v1.0/quote/HK.00700/corporate-actions/splits" | jqResponse Fields
| Name | Type | Description |
|---|---|---|
data | object | |
data.split_list | object[] | Split/consolidation event list (HK). Empty array [] when there are no events |
data.split_list[].dir_deci_pub_date | int | Board resolution announcement date, second-level timestamp, e.g. 1399996800 |
data.split_list[].dir_deci_pub_date_str | string | Board resolution announcement date string (market timezone), format yyyy-MM-dd, e.g. 2014-05-13 |
data.split_list[].reform_type | string | Reorganization type enum. SPLIT / CONSOLIDATION (10) / CONSOLIDATION_THEN_SPLIT (20) / SPLIT_THEN_CONSOLIDATION (25), e.g. 'SPLIT' |
data.split_list[].rate | string | Split/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_date | int | Split/consolidation effective date, second-level timestamp, e.g. 1400112000 |
data.split_list[].ex_date_str | string | Split/consolidation effective date string (market timezone), format yyyy-MM-dd, e.g. 2014-05-15 |
data.split_list[].sm_deci_date | int | Shareholders' meeting resolution date, second-level timestamp |
data.split_list[].sm_deci_date_str | string | Shareholders' meeting resolution date string (market timezone), format yyyy-MM-dd |
data.split_list[].temp_trade_begin_date | int | Temporary code trading start date, second-level timestamp |
data.split_list[].temp_trade_begin_date_str | string | Temporary code trading start date string, format yyyy-MM-dd |
data.split_list[].simul_trade_begin_date | int | Old/new parallel trading start date, second-level timestamp |
data.split_list[].simul_trade_begin_date_str | string | Old/new parallel trading start date string, format yyyy-MM-dd |
data.split_list[].simul_trade_end_date | int | Old/new parallel trading end date, second-level timestamp |
data.split_list[].simul_trade_end_date_str | string | Old/new parallel trading end date string, format yyyy-MM-dd |
data.split_list[].event_status | string | Event status text, e.g. 'Plan Implementation' |
data.split_list[].scheme_statement | string | Scheme statement (free text describing the split/consolidation plan) |
data.split_list[].new_par_value | number | New par value (in reporting currency). e.g. 0.00002 (HKD) |
data.split_list[].temp_share_code | string | Temporary stock code (without market prefix), e.g. '02988' |
data.split_list[].temp_share_abbr_name | string | Temporary stock short name, e.g. 'Tencent' |
data.split_list[].new_trade_unit | int | New lot size, e.g. 100 |
data.split_list[].shares_after_effect | number | Total shares after effective date (in shares). e.g. 9319999970 |
pagination | object | |
pagination.has_more | bool | |
pagination.next_key | string |
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 | Service 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": 2e-05,
"temp_share_code": "02988",
"temp_share_abbr_name": "Tencent",
"new_trade_unit": 100,
"shares_after_effect": 9319999970
}
]
}
}