Skip to content

Dividends ​

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

Get 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 ​

NameTypeInRequiredDescription
symbolstringpathyesSymbol code, e.g. HK.00700.

Request Example ​

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

Response Fields ​

data top-level fields:

NameTypeDescription
dataobject
data.dividend_listobject[]
data.dividend_list[].fiscal_yearstringFiscal year (string), e.g. '2025'. Populated only for HK and A-share; empty for other markets
data.dividend_list[].statementstringDividend 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[].processstringEvent processing status. Values 'Implementation' / 'Plan'; populated only for HK and A-share, empty for other markets
data.dividend_list[].dividend_per_sharenumberCash 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[].currencystringDividend currency (HK/US only), e.g. 'HKD' / 'USD'
data.dividend_list[].payout_rationumberDividend payout ratio (percent, A-share only). e.g. 36.443893 means ~36.44%
data.dividend_list[].dividend_typestringDividend 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_datestringEx-dividend / ex-rights date, format yyyy/MM/dd (empty if missing), e.g. '2026/05/15'
data.dividend_list[].record_datestringRecord date, format yyyy/MM/dd, e.g. '2026/05/18'
data.dividend_list[].dividend_payable_datestringDividend payable date, format yyyy/MM/dd, e.g. '2026/06/01'
data.dividend_list[].pub_datestringAnnouncement date, format yyyy/MM/dd, e.g. '2026/03/18'
data.total_dividend_countintCumulative number of historical dividends (top-level). Not provided for US market. e.g. 26
data.total_dividend_moneystringCumulative 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
paginationobjectPagination returned by some endpoints

dividend_list element fields:

FieldTypeDescription
fiscal_yearstringFiscal year. Only returned for HK / A-shares.
statementstringDividend plan description.
dividend_per_sharenumberCash dividend per share (reporting currency).
currencystringDividend currency. Only returned for HK / US.
payout_rationumberDividend payout ratio (%). Only returned for A-shares.
dividend_typestringDividend type. Only returned for Morningstar markets (SG/CA/AU/JP).
processstringPlan progress: Implementation / Plan.
ex_datestringEx-dividend date (YYYY/MM/DD).
record_datestringRecord date.
dividend_payable_datestringPayment date.
pub_datestringAnnouncement 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_codeerror.codeTrigger ConditionSuggested Action
0—Success (including empty list when no dividend records)—
-3invalid_parameterInvalid symbol formatFix the symbol and retry
-7invalid_symbolCode cannot be resolved to a securityUse the search API to verify the symbol
-2 / -4 / -6internal_errorService errorRetry 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"
      }
    ]
  }
}