Stock Splits Calendar拆合股日历
该接口按自定义起止日期区间返回全市场即将实施或历史已完成的股票拆股与合股日程表。通过汇总除权日期、股票代码与拆合股分子分母比例，它为实盘交易持仓头寸折算、止损单价格同步及拆股事件驱动策略提供前置日历预警。
https://quote-fmp.com/stable/splits-calendar数据更新周期
1-2 Hours
接口说明
- 实盘交易持仓头寸与挂单盘前校准：若持仓标的在今日发生拆股或合股，而量化交易系统未在盘前同步更新基准价格与持仓数量，极易因除权后的价格剧烈跳变误触发止损平仓或风控熔断。每日盘前拉取该日历即可提前对当日除权标的执行头寸与挂单折算。
- 拆股效应事件驱动策略标的扫描：学术界与实盘均广泛关注明星科技股宣布拆股后至正式除权日前后的流动性溢价与动量效应。通过该日历按未来日期区间扫描，可一次性锁定全市场即将迎来除权生效日的正向拆股标的池。
- 全市场历史拆合股事件批量归档：相比按单只股票逐个查询拆股历史，数据工程团队可通过按月或按年切片调用该日历接口，高效批量同步全市场所有上市公司在特定历史时期的股本拆合记录，快速构建全局企业行动（Corporate Actions）事件库。
- 跨模块关联接口：Earnings Report（公司财报数据） · Earnings Calendar（财报日历） · Global Exchange Market Hours（全球交易所交易时段） · Press Releases（公司新闻稿）
请求参数
3 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
from | date | 可选 | 2026-03-06 | 查询起始日期，格式 YYYY-MM-DD，包含当天。 |
to | date | 可选 | 2026-06-06 | 查询结束日期，格式 YYYY-MM-DD，包含当天。 |
page | number | 可选 | 0 | 分页页码，从 0 开始，配合每页条数翻页取更多数据（从 0 起算的分页游标；当响应返回空数组 [] 时代表已翻至历史末页） |
调用代码示例
Python 关键代码采集 拆合股日历（/stable/splits-calendar）需传可选 from, to，重点读取 numerator（拆股分子）、denominator（拆股分母）、splitType（拆股类型）（样本 numerator=1）。
resp = requests.get(
"https://quote-fmp.com/stable/splits-calendar",
params={"from": "2026-03-06", "to": "2026-06-06", "page": 0, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 date 升序重排并数值化 numerator（拆股分子）
df["numerator"] = pd.to_numeric(df["numerator"], errors="coerce")
df = df.sort_values("date").reset_index(drop=True)参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 传入一季度起止日期提取拆合股日历列表 | from=2025-01-01&to=2025-03-31 | 请求 /stable/splits-calendar 并指定 2025 一季度边界，一次拿齐该时段的 numerator、denominator、splitType 等核心字段。 |
| 分段拉取 2024 下半年拆合股日历全量记录 | from=2024-07-01&to=2024-12-31 | 通过半年期滑窗参数请求 /stable/splits-calendar，稳定拉取 2024H2 期间的 numerator、denominator、splitType 记录。 |
对接 /stable/splits-calendar（拆合股日历，可选 from, to）时，重点字段 numerator（1）与 denominator（5）反映当期截面状态，跨期比较前须对齐时间粒度。
清洗拆合股日历响应时，先按 (symbol, date) 剔除重复行，再提取 numerator（拆股分子，样本 1）构造量化指标。
返回数据
5 个字段本接口示例响应共包含 5 个字段（数值型 2 个，文本/日期/布尔型 3 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "WHLR" | 证券代码 |
date | string | "2026-07-28" | 日期 |
numerator | number | 1 | 拆股分子 |
denominator | number | 5 | 拆股分母 |
splitType | string | "stock-split" | 拆股类型 |
查看响应数据示例（原始 JSON）
[
{
"symbol": "WHLR",
"date": "2026-07-28",
"numerator": 1,
"denominator": 5,
"splitType": "stock-split"
}
]常见问题解答（FAQ）
2 个问题请求 /stable/splits-calendar 获取拆合股日历时有哪些必填项？它与 公司拆合股明细 的边界在哪？
拆合股日历（/stable/splits-calendar）采用可选 from, to查询，返回首条样本如 numerator=1（共 5 列）；同模块相邻的 Stock Split Details（公司拆合股明细）则包含 5 列。
初次建库回填拆合股日历与日常增量拉取 /stable/splits-calendar，在传参方式上有何技巧？
在量化管道中，应按日历窗口设置 from 和 to 边界调用 /stable/splits-calendar；若并发拉取多组任务，请结合网关 RPM 配额控制并发协程数，稳健采集 numerator。
同模块相关接口对比
Splits本接口路径 /stable/splits-calendar，无必填参数。 同一模块「Splits」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司拆合股明细Stock Split Details | /stable/splits | 指定股票自上市以来的全部历史拆股（正向分割）与合股（反向缩股）事件明细 |