三、财务信息
3.16 分红与拆股
GET
/api/dividend_pageGET
/api/split_page分红事件、拆股与合股事件，分页，每页 100 条。
请求
请求头 Authorization：你的密钥（必填）。
| 参数 | 是否必填 | 说明 |
|---|---|---|
| country | 必填 | 国家，如 america；全部取值见「国家与市场参数」 |
| market | 可选 | 市场代码；不传查整个国家 |
| symbol | 可选 | 产品代码，和 market 一起传，查单个产品 |
| page | 可选 | 页码，默认 1 |
说明
dividend_page是分红，split_page是拆股与合股，参数相同。- 三种范围：只传 country 查整个国家；country + market 查这个市场；country + market + symbol 查单个产品。按国家或市场查时，每条多出 exchange、symbol、name。
- 只收录近期的事件；查单个产品而它近期没有分红或拆股时，
data是空数组。 - 分红每条：ex_dividend_date 除息日、record_date、pay_date 派息日、announce_date、cash_per_share 每股金额、yield_pct 股息率、currency_code、kind、frequency、state、updated_at。
- 拆股每条：effective_date 生效日、kind（SPLIT 拆股）、ratio_from、ratio_to、ratio_text（如 "1 -> 2"）、state、updated_at。
- 日期都是 Unix 秒；外壳里
page是当前页、total是总条数、message为 null。
返回
统一外壳 {status, message, data, total, page, market, symbol, code, interval}，数据在 data 里。出错时 HTTP 状态码仍是 200，status 为 500，message 是原因。
错误
| HTTP | 返回 | 情况 |
|---|---|---|
| 200 | {"Cmd":"api","State":-1,"Msg":"没有订阅产品权限"} | 没带 country |
| 200 | status=500 No Symbol | 查单个产品时找不到这个产品 |
| 200 | status=500 page is invalid number! | page 不是正整数 |
示例：dividend_page，整个国家
GET
/dividend_page?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": null, // 成功时为 null，失败时是原因
"data": [ // 每页 100 条
{
"exchange": "AMEX", // 交易所
"symbol": "DIV", // 产品代码
"name": "Global X Super Dividend ETF", // 名称
"ex_dividend_date": 1791158400, // 除息日，Unix 秒
"record_date": null, // 股权登记日
"pay_date": 1791417600, // 派息日，Unix 秒
"announce_date": null, // 公告日
"cash_per_share": 0.105999999, // 每股金额
"yield_pct": 6.6631578947, // 股息率（%）
"currency_code": "USD", // 币种
"kind": "cash", // 类型
"frequency": null, // 频率
"state": "confirmed", // 状态
"updated_at": "2026-10-05 00:00:33" // 更新时间
}
],
"total": 4692, // 总条数
"page": 1, // 当前页
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 100 条，示例只列出前 1 条。
示例：dividend_page，单个产品（AAPL 近期没有分红，所以是空数组）
GET
/dividend_page?country=america&market=NASDAQ&symbol=AAPL请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": null, // 成功时为 null，失败时是原因
"data": [], // 数据
"total": 0, // 总条数
"page": 1, // 当前页
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}
示例：split_page
GET
/split_page?country=america请求头 Authorization: 你的密钥 · HTTP 200
{
"status": 0, // 0 成功，500 失败
"message": null, // 成功时为 null，失败时是原因
"data": [ // 每页 100 条
{
"exchange": "OTC", // 交易所
"symbol": "HSHIF", // 产品代码
"name": "Hoshizaki Electric Co.", // 名称
"effective_date": 1798502400, // 生效日，Unix 秒
"kind": "SPLIT", // SPLIT 拆股
"ratio_from": 1, // 比例：从几股
"ratio_to": 2, // 比例：变成几股
"ratio_text": "1 -> 2", // 比例的文字写法
"state": "announced", // 状态
"updated_at": "2026-10-05 00:33:39" // 更新时间
}
],
"total": 218, // 总条数
"page": 1, // 当前页
"market": null, // 市场代码
"symbol": null, // 产品代码
"code": null, // 产品代码
"interval": null // K 线周期，这类接口不用
}data 共 100 条，示例只列出前 1 条。