分红派息
GET/v1/quote/{symbol}/f10/dividends获取股票的分红派息历史记录(按时间倒序,最多 100 条)。每条返回财年、方案描述、每股现金分红与币种、股利支付率、分红类型、方案进度及关键日期。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 证券代码,如 HK.00700。 |
请求示例
bash
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 | 网关内部错误 | 稍后重试,持续失败请反馈 |
响应示例
json
{
"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"
}
]
}
}