Dividends
GET/api/v1.0/quote/{symbol}/corporate-actions/dividendsGet the dividend payment history for a stock (sorted by time descending, max 100 records). Each record returns fiscal year, plan description, cash dividend per share with currency, payout ratio, dividend type, plan progress, and key dates.
Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
symbol | string | path | yes | Symbol code, e.g. HK.00700. |
Request Example
bash
curl "https://webapi.futunn.com/api/v1.0/quote/HK.00700/corporate-actions/dividends" | jqResponse Fields
data top-level fields:
| Name | Type | Description |
|---|---|---|
data | object | |
data.dividend_list | object[] | |
data.dividend_list[].fiscal_year | string | Fiscal year (string), e.g. '2025'. Populated only for HK and A-share; empty for other markets |
data.dividend_list[].statement | string | Dividend description (free text, English). 'Cash Dividend: X CCY Per Share' for HK/US/SG/CA/AU/JP; 'Cash Dividend: X CNY Per 10 Shares (Before Tax)' for A-share. e.g. 'Cash Dividend: 5.30000 HKD Per Share' |
data.dividend_list[].process | string | Event processing status. Values 'Implementation' / 'Plan'; populated only for HK and A-share, empty for other markets |
data.dividend_list[].dividend_per_share | number | Cash dividend per share (reporting currency), computed as amount/base/1e5. Structured value provided only for HK/US; 0 for A-share/Morningstar markets (parse the statement text instead). e.g. 5.30 |
data.dividend_list[].currency | string | Dividend currency (HK/US only), e.g. 'HKD' / 'USD' |
data.dividend_list[].payout_ratio | number | Dividend payout ratio (percent, A-share only). e.g. 36.443893 means ~36.44% |
data.dividend_list[].dividend_type | string | Dividend type description (Morningstar markets SG/CA/AU/JP etc. and ETFs only), e.g. 'Regular Cash'. HK/US/A-share not separately classified; see statement |
data.dividend_list[].ex_date | string | Ex-dividend / ex-rights date, format yyyy/MM/dd (empty if missing), e.g. '2026/05/15' |
data.dividend_list[].record_date | string | Record date, format yyyy/MM/dd, e.g. '2026/05/18' |
data.dividend_list[].dividend_payable_date | string | Dividend payable date, format yyyy/MM/dd, e.g. '2026/06/01' |
data.dividend_list[].pub_date | string | Announcement date, format yyyy/MM/dd, e.g. '2026/03/18' |
data.total_dividend_count | int | Cumulative number of historical dividends (top-level). Not provided for US market. e.g. 26 |
data.total_dividend_money | string | Cumulative dividend amount (top-level). NOTE: unit differs by market - HK/A-share is total cash amount (reporting currency, may reach billions), Morningstar markets (SG/CA/AU/JP etc.) is cumulative per-share dividend. Not provided for US. e.g. 220851421161.2 |
pagination | object | Pagination returned by some endpoints |
dividend_list element fields:
| Field | Type | Description |
|---|---|---|
fiscal_year | string | Fiscal year. Only returned for HK / A-shares. |
statement | string | Dividend plan description. |
dividend_per_share | number | Cash dividend per share (reporting currency). |
currency | string | Dividend currency. Only returned for HK / US. |
payout_ratio | number | Dividend payout ratio (%). Only returned for A-shares. |
dividend_type | string | Dividend type. Only returned for Morningstar markets (SG/CA/AU/JP). |
process | string | Plan progress: Implementation / Plan. |
ex_date | string | Ex-dividend date (YYYY/MM/DD). |
record_date | string | Record date. |
dividend_payable_date | string | Payment date. |
pub_date | string | Announcement date. |
Supported Markets
- Supported markets: HK / US / A-shares (SH/SZ) / SG / CA / AU / JP.
- Categories: Primarily equities; ETF / bonds / warrants / options / futures / indices without dividend events return empty lists.
- Output fields vary significantly by market (per-share amount only for HK/US, payout ratio only for A-shares).
Error Codes
| ret_code | error.code | Trigger Condition | Suggested Action |
|---|---|---|---|
| 0 | — | Success (including empty list when no dividend records) | — |
| -3 | invalid_parameter | Invalid symbol format | Fix the symbol and retry |
| -7 | invalid_symbol | Code cannot be resolved to a security | Use the search API to verify the symbol |
| -2 / -4 / -6 | internal_error | Service error | Retry later; report if persistent |
Response Example
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"total_dividend_count": 26,
"total_dividend_money": "220851421161.2",
"dividend_list": [
{
"fiscal_year": "2025",
"statement": "Cash Dividend: 5.30000 HKD Per Share",
"dividend_per_share": 5.3,
"currency": "HKD",
"process": "Implementation",
"ex_date": "2026/05/15",
"record_date": "2026/05/18",
"dividend_payable_date": "2026/06/01",
"pub_date": "2026/03/18"
}
]
}
}