期货期货合约快照 · REST 接口

期货合约实时快照。获取一组期货合约的实时快照，包含最新成交、报价、交易时段指标（开盘价、最高价、最低价、收盘价、成交量）与结算价等关键数据。可按代码或产品代码过滤，支持自定义排序与分页。

GET /futures/v1/snapshot

上游时效说明

延迟 10 分钟或实时

上游历史范围

该接口不适用

适用场景

实时交易系统、盘中市场分析、表现监控、组合估值。

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

查询参数

参数	类型	必填	说明
`product_code`	string	No	合约底层标的产品的代码。
`product_code.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`product_code.gt`	string	No	筛选大于该值。
`product_code.gte`	string	No	筛选大于或等于该值。
`product_code.lt`	string	No	筛选小于该值。
`product_code.lte`	string	No	筛选小于或等于该值。
`ticker`	string	No	期货合约标识，由基础代码与合约到期月构成（如 ESZ24 表示 2024 年 12 月到期的标普 500 E-mini 合约）。
`ticker.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`ticker.gt`	string	No	筛选大于该值。
`ticker.gte`	string	No	筛选大于或等于该值。
`ticker.lt`	string	No	筛选小于该值。
`ticker.lte`	string	No	筛选小于或等于该值。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 50000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 ticker，排序方向默认为 asc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].details`	object	不适用
`results[].last_minute`	object	不适用
`results[].last_quote`	object	不适用
`results[].last_trade`	object	不适用
`results[].session`	object	不适用
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "count": 1,
  "next_url": "https://api.massive.com/futures/v1/snapshot?cursor=AQANAkNCBVNQ",
  "request_id": "c4d50f4801874e30b63e674b844cf51f",
  "results": [
    {
      "details": {
        "settlement_date": 1753851600000000000
      },
      "last_minute": {
        "close": 240.00000000000003,
        "high": 240.00000000000003,
        "last_updated": 1746045300000,
        "low": 240.00000000000003,
        "open": 240.00000000000003,
        "volume": 5
      },
      "last_quote": {
        "ask": 240.50000000000003,
        "ask_size": 3,
        "ask_timestamp": 1746036204386194000,
        "bid": 239.50000000000003,
        "bid_size": 2,
        "bid_timestamp": 1746035747932118000,
        "last_updated": 1746046798024234200
      },
      "last_trade": {
        "last_updated": 1746045242858242600,
        "price": 240.00000000000003,
        "size": 5
      },
      "product_code": "CB",
      "session": {
        "change": 21.11,
        "change_percent": 0.09622134,
        "close": 240.00000000000003,
        "high": 241.00000000000003,
        "low": 240.00000000000003,
        "open": 240.00000000000003,
        "previous_settlement": 219.39,
        "settlement_price": 240.50000000000003,
        "volume": 55
      },
      "ticker": "CBN5"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

期货 期货合约快照 · REST 接口

适用场景

查询参数

响应字段

响应示例

期货期货合约快照 · REST 接口