Dividend Statistics

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

Get F10 dividend statistics summary and annual dividend breakdown for an equity or ETF . Returns: dividend_yield_ttm (percent), payout_ratio_lfy (percent, equities only), distribution_frequency (times/year), total dividend_count, recent_dividend, next_dividend, and annual_dividends list. For item-by-item dividend history use quote.corporate_actions_dividends; for market-wide dividend calendar use quote.dividend_calendar.

Request

Parameter	Type	In	Required	Description
symbol	string	path	yes	Security symbol (path parameter), format MARKET.CODE, e.g. US.AAPL / HK.00700 / HK.02800
annual_count	int	query	no	Number of annual dividend records to return, default 5, range 1~30

Example

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/corporate-actions/dividend-statistics?annual_count=1' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response

Field	Type	Description
data.dividend_count	string	Total historical dividend count
data.dividend_yield_ttm	string	Trailing 12-month dividend yield (percent, 5.00 means 5%)
data.payout_ratio_lfy	string	Last fiscal year payout ratio (percent, equities only; 0 for ETFs)
data.distribution_frequency	string	Distribution frequency (times per year)
data.recent_dividend	object	Most recent dividend details
data.recent_dividend[].statement	string	Dividend statement
data.recent_dividend[].ex_date	string	Ex-dividend date
data.recent_dividend[].payable_date	string	Dividend payable date
data.recent_dividend[].pub_date	string	Announcement date
data.recent_dividend[].ex_date_timestamp	integer	Ex-dividend timestamp in seconds
data.next_dividend	object	Next upcoming dividend (empty if none)
data.next_dividend[].statement	string	Dividend statement
data.next_dividend[].ex_date	string	Ex-dividend date
data.next_dividend[].payable_date	string	Dividend payable date
data.next_dividend[].pub_date	string	Announcement date
data.annual_dividends	object	Annual dividend summary list (newest year first)
data.annual_dividends[].year	string	Calendar year, e.g. '2025'
data.annual_dividends[].annual_dividend_per_share	number	Annual dividend per share
data.annual_dividends[].annual_dividend_yield	number	Annual dividend yield (percent)
data.annual_dividends[].currency	string	Currency unit, e.g. USD / HKD / CNY

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "dividend_count": "example",
    "dividend_yield_ttm": "example",
    "payout_ratio_lfy": "example",
    "distribution_frequency": "example",
    "recent_dividend": "example",
    "next_dividend": "example",
    "annual_dividends": "example"
  }
}