美股 拆合股 · REST 接口
拆合股(含复权因子)。获取历史拆合股事件,包括执行日期与比例因子,并可获得用于将历史价格还原到当前股本口径的复权因子。
GET /stocks/v1/splits上游时效说明
每日更新
上游历史范围
数据可追溯至 1978 年 10 月 25 日
适用场景
- 历史分析、价格还原、数据一致性、建模。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
ticker | string | No | 执行拆合股公司的股票代码 |
ticker.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
ticker.gt | string | No | 筛选大于该值。 |
ticker.gte | string | No | 筛选大于或等于该值。 |
ticker.lt | string | No | 筛选小于该值。 |
ticker.lte | string | No | 筛选小于或等于该值。 |
execution_date | string | No | 拆合股生效的日期。调整在隔夜完成。在前一个交易日,盘后时段是最后一个显示拆分前价格的时段。到执行日,所有交易(包括盘前时段)均已按拆合股调整。取值必须为 yyyy-mm-dd 格式。 |
execution_date.gt | string | No | 筛选大于该值。值格式须为 yyyy-mm-dd。 |
execution_date.gte | string | No | 筛选大于或等于该值。值格式须为 yyyy-mm-dd。 |
execution_date.lt | string | No | 筛选小于该值。值格式须为 yyyy-mm-dd。 |
execution_date.lte | string | No | 筛选小于或等于该值。值格式须为 yyyy-mm-dd。 |
adjustment_type | string | No | 股本变动事件的分类。可选值包括:forward_split(股数增加)、reverse_split(股数减少)、stock_dividend(以股票形式派发的分红) |
adjustment_type.any_of | string | No | 筛选等于任一给定值。多个值可用逗号分隔的列表指定。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 5000。 |
sort | string | No | 逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 execution_date,排序方向默认为 desc。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].adjustment_type | string | 股本变动事件的分类。可选值包括:forward_split(股数增加)、reverse_split(股数减少)、stock_dividend(以股票形式派发的分红) |
results[].execution_date | string | 拆合股生效的日期。调整在隔夜完成。在前一个交易日,盘后时段是最后一个显示拆分前价格的时段。到执行日,所有交易(包括盘前时段)均已按拆合股调整。 |
results[].historical_adjustment_factor | number | 用于抵销拆合股对历史价格影响的累计复权因子。要按拆合股调整历史价格:对于日期 D 的价格,找到 execution_date 晚于 D 的第一次拆合股,并将未复权价格乘以 historical_adjustment_factor。 |
results[].id | string | 每次拆合股事件的唯一标识。 |
results[].split_from | number | 拆分比例的分母(原股份)。 |
results[].split_to | number | 拆分比例的分子(新股份)。 |
results[].ticker | string | 执行拆合股公司的股票代码 |
status | enum: OK | 本次请求响应的状态。 |
响应示例
{
"request_id": 1,
"results": [
{
"adjustment_type": "forward_split",
"execution_date": "2005-02-28",
"historical_adjustment_factor": 0.017857,
"id": "E90a77bdf742661741ed7c8fc086415f0457c2816c45899d73aaa88bdc8ff6025",
"split_from": 1,
"split_to": 2,
"ticker": "AAPL"
}
],
"status": "OK"
}原文:Massive 文档 ↗