分紅派息統計

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

獲取指定標的（正股或 ETF）的 F10 分紅派息統計摘要與歷年年度股息彙總。 返回包含：股息率 TTM（百分數）、股息支付率 LFY（百分數，僅正股）、派息頻率（次/年）、歷史累計派息次數、最近一次派息詳情、下一次派息預告，以及按自然年降序排列的年度每股股息與年度股息率列表。 逐筆歷史派息記錄請用 quote.corporate_actions_dividends；全市場派息日曆請用 quote.dividend_calendar。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	證券代碼（路徑參數），格式 MARKET.CODE，例: US.AAPL / HK.00700 / HK.02800
annual_count	int	查詢	否	返回的自然年年度股息條數，默認 5，範圍 1~30

請求示例

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

響應參數

參數	類型	說明
data.dividend_count	string	歷史累計派息總次數
data.dividend_yield_ttm	string	股息率 TTM（百分數，5.00 表示 5%）
data.payout_ratio_lfy	string	股息支付率 LFY（百分數，僅正股返回，ETF 為 0）
data.distribution_frequency	string	派息頻率（次/年）
data.recent_dividend	object	最近一次派息詳情
data.recent_dividend[].statement	string	派息方案說明
data.recent_dividend[].ex_date	string	除淨日
data.recent_dividend[].payable_date	string	派息日
data.recent_dividend[].pub_date	string	公告日
data.recent_dividend[].ex_date_timestamp	integer	除淨日秒級時間戳
data.next_dividend	object	下一次派息預告（無未來派息時為空對象）
data.next_dividend[].statement	string	派息方案說明
data.next_dividend[].ex_date	string	除淨日
data.next_dividend[].payable_date	string	派息日
data.next_dividend[].pub_date	string	公告日
data.annual_dividends	object	歷年自然年股息彙總列表（按年份從新到舊）
data.annual_dividends[].year	string	自然年年份，例: '2025'
data.annual_dividends[].annual_dividend_per_share	number	自然年每股股息合計
data.annual_dividends[].annual_dividend_yield	number	自然年股息率（百分數，1000000 原始值對應 100%）
data.annual_dividends[].currency	string	股息貨幣單位，例: USD / HKD / CNY

錯誤碼

ret_code	error.code	說明
0	—	成功
-3	invalid_parameter	參數缺失或不在允許範圍內
-7	invalid_symbol	標的不存在
-8	unsupported	市場或品類不支持
-9	permission_denied	沒有對應權限
-10	no_data	沒有可返回的數據
-11	rate_limited	調用過於頻繁

響應示例

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