查询基金分红、登记日、除息日和派息日。
- 数据范围
- 有分红事件记录的公募基金
- 包含内容
- 分红进度、登记日、除息日、派息日、每份派息及可用分配金额
- 时间覆盖
- 历史分红已核实含 2002-06-26 除息事件（000001.OF 样例）；按事件公告日、除息日和派息日提供，各基金起点不同，非每日连续数据
- 数据频率
- 分红事件
基金分红
POST
https://jinniu.lingxideai.com/api/fund_div查询基金分红、权益登记日、除息日和派息日；没有记录不等于基金资料缺失。
共用“ETF、基金、LOF历史”权限及期限，一次开通即可使用 ETF、LOF 历史和本组公募基金接口；不包含实时权限。覆盖起始日期随基金与数据项不同，以实际可用记录为准，不承诺所有基金全历史完整覆盖。
ts_code、ann_date、ex_date、pay_date 至少填一个。
| 参数 | 必填 | 说明 |
|---|---|---|
| api_key | 是 | 账户 API Key，也可通过 X-Api-Key 请求头传入。 |
| ts_code | 条件见上文 | 基金代码，如 001753.OF、159995.SZ；基金经理支持逗号分隔的多个代码（最多100个），其余接口限单个。 |
| ann_date | 条件见上文 | 公告日期，YYYYMMDD 或 YYYY-MM-DD。 |
| ex_date | 条件见上文 | 除息日期，YYYYMMDD 或 YYYY-MM-DD。 |
| pay_date | 条件见上文 | 派息日期，YYYYMMDD 或 YYYY-MM-DD。 |
| limit | 否 | 1 至 2000，默认 2000；全站设置与本接口上限取较小值。 |
| offset | 否 | 偏移行数，默认0，最大10000000；保持筛选条件不变，按 next_offset 继续。可能有下一页不代表一定还有记录。 |
| fields | 否 | 逗号分隔的返回字段；不填返回默认字段。可选：ts_code,ann_date,imp_anndate,base_date,div_proc,record_date,ex_date,pay_date,earpay_date,net_ex_date,div_cash,base_unit,ear_distr,ear_amount,account_date,base_year。 |
调用示例
curl -X POST 'https://jinniu.lingxideai.com/api/fund_div' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-d '{"ann_date": "20181018", "limit": 2}'返回字段
| 字段 | 说明 |
|---|---|
| ts_code | 基金代码；无单位。 |
| ann_date | 公告日期，YYYYMMDD。 |
| imp_anndate | 分红实施公告日期。 |
| base_date | 收益分配基准日。 |
| div_proc | 分配方案进度。 |
| record_date | 权益登记日。 |
| ex_date | 除息日。 |
| pay_date | 派息日。 |
| earpay_date | 收益支付日。 |
| net_ex_date | 净值除权日。 |
| div_cash | 每份派息，单位：元/份。 |
| base_unit | 分红基准基金份额，单位：万份。 |
| ear_distr | 可供分配收益，单位：元人民币。 |
| ear_amount | 收益分配金额，单位：元人民币。 |
| account_date | 红利再投资到账日。 |
| base_year | 分红年度。 |
| data.meta.returned_count / limit / max_rows / offset / next_offset | 本页数量、分页大小、有效上限、当前偏移、下一页偏移；单位：条。末页 next_offset 为 null。 |
| data.meta.possibly_more | 本页是否已满。缺失数值保留 null，不补零。 |
返回结构示例
{"data": {"fields": ["ts_code", "ann_date", "imp_anndate", "base_date", "div_proc", "record_date", "ex_date", "pay_date", "earpay_date", "net_ex_date", "div_cash", "base_unit", "ear_distr", "ear_amount", "account_date", "base_year"], "items": [], "meta": {"limit": 2, "next_offset": null, "offset": 0, "possibly_more": false, "returned_count": 0}}, "message": "", "success": true}SDK：client.fund_div(...)；MCP 工具：fund_div。参数错误返回 HTTP 400 和英文原因；服务暂不可用返回 HTTP 503，不伪装为空数据。调用频率、并发及错误处理统一见调用规则。