分红派息统计
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 |
请求示例
bash
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 | 调用过于频繁 |
响应示例
json
{
"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"
}
}