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

Name	Type	In	Required	Description
symbol	string	path	yes	Symbol code, e.g. HK.00700.

Request Example

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

Response Fields

data top-level fields:

Field	Type	Description
total_dividend_count	int	Total historical dividend count.
total_dividend_money	number	Total historical dividend amount (reporting currency).

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	Gateway internal error	Retry later; report if persistent

Response Example

{
  "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"
      }
    ]
  }
}