分紅派息

GET /v1/quote/{symbol}/f10/dividends

獲取股票的分紅派息歷史記錄（按時間倒序，最多 100 條）。每條返回財年、方案描述、每股現金分紅與幣種、股利支付率、分紅類型、方案進度及關鍵日期。

請求參數

參數	類型	位置	必填	說明
symbol	string	路徑	是	證券代碼，如 HK.00700。

請求示例

curl "$ip/v1/quote/HK.00700/f10/dividends" | jq

響應字段

data 頂層字段：

字段	類型	說明
total_dividend_count	int	歷史累計分紅次數。
total_dividend_money	number	歷史累計分紅金額（報告幣種）。

dividend_list 元素字段：

字段	類型	說明
fiscal_year	string	財政年度。僅 HK / A 股返回。
statement	string	分紅方案描述。
dividend_per_share	number	每股現金分紅（報告幣種）。
currency	string	派息幣種。僅 HK / US 返回。
payout_ratio	number	股利支付率（%）。僅 A 股返回。
dividend_type	string	分紅類型。僅晨星市場（SG/CA/AU/JP）返回。
process	string	方案進度：Implementation（已實施）/ Plan（預案）。
ex_date	string	除權除息日（YYYY/MM/DD）。
record_date	string	股權登記日。
dividend_payable_date	string	派息日。
pub_date	string	公告日。

限制範圍

• 支持市場：HK / US / A 股（SH/SZ）/ SG / CA / AU / JP。
• 支持品類：以正股為主；ETF / 債 / 窩輪 / 期權 / 期貨 / 指數等無派息事件的標的返回空列表。
• 出參字段按市場差異較大（每股金額僅 HK/US、股利支付率僅 A 股）。

錯誤碼

ret_code	error.code	觸發條件	處理建議
0	—	成功（含無派息記錄時的空列表）	—
-3	invalid_parameter	symbol 格式非法	校正 symbol 後重試
-7	invalid_symbol	代碼無法解析為證券	通過 search 接口確認代碼合法性
-2 / -4 / -6	internal_error	網關內部錯誤	稍後重試，持續失敗請反饋

響應示例

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