指数指数快照 · REST 接口

指数快照。获取一个或多个指数的快照，包括当前数值、近期表现指标与交易时段细节，便于评估市场状况、跟踪整体经济情绪并将指数级数据接入交易或分析流程。

GET /v3/snapshot/indices

上游时效说明

延迟 15 分钟或实时

上游历史范围

该接口不适用

适用场景

市场状况评估、经济情绪跟踪、组合背景分析、指数数据集成分析。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`ticker.any_of`	string	No	逗号分隔的标的代码列表，最多 250 个。若未传入任何代码，则以分页方式返回全部结果。注意：URL 可容纳的字符数上限取决于你的技术栈。
`ticker`	string	No	指定单个指数代码，例如 I:SPX。指数代码区分大小写并以 I: 开头。若要请求多个代码或一个代码区间，请展开筛选修饰符。
`ticker.gte`	string	No	按 ticker 范围筛选。
`ticker.gt`	string	No	按 ticker 范围筛选。
`ticker.lte`	string	No	按 ticker 范围筛选。
`ticker.lt`	string	No	按 ticker 范围筛选。
`order`	string	No	按 sort 字段对结果排序。
`limit`	integer	No	限制返回结果数量，默认 10，最大 250。
`sort`	string	No	用于排序的字段。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	包含所请求数据的数组。
`results[].error`	string	查找该标的时发生的错误。
`results[].last_updated`	integer	该信息更新时的纳秒时间戳。
`results[].market_status`	string	交易该代码所属市场的市场状态。
`results[].message`	string	查找该标的时的错误信息。
`results[].name`	string	指数名称。
`results[].session`	object	当日交易时段指标，给出该资产在当前交易日内的涨跌幅与关键价格点（开盘价、收盘价、最高价、最低价）。
`results[].ticker`	string	所查询资产的代码。
`results[].timeframe`	enum: DELAYED, REAL-TIME	数据的时间相关性。
`results[].type`	enum: indices	指数市场。
`results[].value`	number	指数数值。
`status`	string	本次请求响应的状态。

响应示例

{
  "request_id": "6a7e466379af0a71039d60cc78e72282",
  "results": [
    {
      "last_updated": 1679597116344223500,
      "market_status": "closed",
      "name": "Dow Jones Industrial Average",
      "session": {
        "change": -50.01,
        "change_percent": -1.45,
        "close": 3822.39,
        "high": 3834.41,
        "low": 38217.11,
        "open": 3827.38,
        "previous_close": 3812.19
      },
      "ticker": "I:DJI",
      "timeframe": "REAL-TIME",
      "type": "indices",
      "value": 3822.39
    },
    {
      "error": "NOT_FOUND",
      "message": "Ticker not found.",
      "ticker": "APx"
    },
    {
      "error": "NOT_ENTITLED",
      "message": "Not entitled to this ticker.",
      "ticker": "APy"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

指数 指数快照 · REST 接口

适用场景

查询参数

响应字段

响应示例

指数指数快照 · REST 接口