REST 接口 · 文档目录

美股 拆合股 · REST 接口

拆合股(含复权因子)。获取历史拆合股事件,包括执行日期与比例因子,并可获得用于将历史价格还原到当前股本口径的复权因子。

GET /stocks/v1/splits
上游时效说明

每日更新

上游历史范围

数据可追溯至 1978 年 10 月 25 日

适用场景

  • 历史分析、价格还原、数据一致性、建模。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
tickerstringNo执行拆合股公司的股票代码
ticker.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
ticker.gtstringNo筛选大于该值。
ticker.gtestringNo筛选大于或等于该值。
ticker.ltstringNo筛选小于该值。
ticker.ltestringNo筛选小于或等于该值。
execution_datestringNo拆合股生效的日期。调整在隔夜完成。在前一个交易日,盘后时段是最后一个显示拆分前价格的时段。到执行日,所有交易(包括盘前时段)均已按拆合股调整。取值必须为 yyyy-mm-dd 格式。
execution_date.gtstringNo筛选大于该值。值格式须为 yyyy-mm-dd。
execution_date.gtestringNo筛选大于或等于该值。值格式须为 yyyy-mm-dd。
execution_date.ltstringNo筛选小于该值。值格式须为 yyyy-mm-dd。
execution_date.ltestringNo筛选小于或等于该值。值格式须为 yyyy-mm-dd。
adjustment_typestringNo股本变动事件的分类。可选值包括:forward_split(股数增加)、reverse_split(股数减少)、stock_dividend(以股票形式派发的分红)
adjustment_type.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
limitintegerNo限制返回结果的最大数量。未指定时默认为 100,允许的最大值为 5000。
sortstringNo逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 execution_date,排序方向默认为 desc。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].adjustment_typestring股本变动事件的分类。可选值包括:forward_split(股数增加)、reverse_split(股数减少)、stock_dividend(以股票形式派发的分红)
results[].execution_datestring拆合股生效的日期。调整在隔夜完成。在前一个交易日,盘后时段是最后一个显示拆分前价格的时段。到执行日,所有交易(包括盘前时段)均已按拆合股调整。
results[].historical_adjustment_factornumber用于抵销拆合股对历史价格影响的累计复权因子。要按拆合股调整历史价格:对于日期 D 的价格,找到 execution_date 晚于 D 的第一次拆合股,并将未复权价格乘以 historical_adjustment_factor。
results[].idstring每次拆合股事件的唯一标识。
results[].split_fromnumber拆分比例的分母(原股份)。
results[].split_tonumber拆分比例的分子(新股份)。
results[].tickerstring执行拆合股公司的股票代码
statusenum: 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 文档 ↗