REST 接口 · 文档目录

美股 代码变更事件 · REST 接口

代码变更事件。获取与指定股票代码、CUSIP 或综合 FIGI 关联的关键事件时间线。该接口为实验性功能,重点呈现代码变更(如更名、品牌变更),帮助在记录与分析中保持连续性。

GET /vX/reference/tickers/{id}/events
上游时效说明

每日更新

上游历史范围

数据可追溯至 2003 年 9 月 10 日

适用场景

  • 股票代码变更的历史参考、数据连续性、档案留存。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
idstringYes资产的标识,可以是代码、CUSIP 或 Composite FIGI。请指定区分大小写的代码(如 AAPL 表示 Apple Inc)。传入代码时,返回该代码当前所代表实体的相关事件。若要查询过去曾与该代码关联的实体的事件,请通过代码详情接口获取相应标识。
typesstringNo以逗号分隔的、要包含的事件类型列表。目前仅支持 ticker_change 这一种 event_type。留空则返回全部受支持的 event_type。

响应字段

字段类型说明
request_idstring服务器分配的请求 ID。
resultsobject包含所指定代码的事件数据。
results.eventsarray[object]包含所请求数据的事件数组。
results.namestring资产名称。
statusstring本次请求响应的状态。

响应示例

{
  "request_id": "31d59dda-80e5-4721-8496-d0d32a654afe",
  "results": {
    "events": [
      {
        "date": "2022-06-09",
        "ticker_change": {
          "ticker": "META"
        },
        "type": "ticker_change"
      },
      {
        "date": "2012-05-18",
        "ticker_change": {
          "ticker": "FB"
        },
        "type": "ticker_change"
      }
    ],
    "name": "Meta Platforms, Inc. Class A Common Stock"
  },
  "status": "OK"
}

原文:Massive 文档 ↗