期货交易时间表 · REST 接口

期货交易时间表。统一获取期货市场的交易时间安排，返回精确的开市与收市时间、盘中休市以及对节假日与特殊事件的调整。可按 session_end_date 筛选，或用产品代码查询单个产品的时间表。所有时间均为 UTC，便于跨系统对齐交易与运维流程。该接口目前提供 2 年历史数据。

GET /futures/v1/schedules

上游时效说明

每日更新

上游历史范围

数据可追溯至 2024 年 6 月 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	筛选小于或等于该值。
`session_end_date`	string	No	交易时刻表的时段结束日期（也称交易日）。该字段可选，可用于按特定时段结束日期筛选结果。留空则返回所有日期的时刻表。注意交易时段在美国中部时间下午 5 点结束，因此中部时间 1 月 1 日下午 5 点结束的时段，其 session_end_date 为 2025-01-01。取值必须为 yyyy-mm-dd 格式。
`session_end_date.gt`	string	No	筛选大于该值。值格式须为 yyyy-mm-dd。
`session_end_date.gte`	string	No	筛选大于或等于该值。值格式须为 yyyy-mm-dd。
`session_end_date.lt`	string	No	筛选小于该值。值格式须为 yyyy-mm-dd。
`session_end_date.lte`	string	No	筛选小于或等于该值。值格式须为 yyyy-mm-dd。
`trading_venue`	string	No	该时间表对应产品所属交易所的交易场所（MIC）。
`trading_venue.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`trading_venue.gt`	string	No	筛选大于该值。
`trading_venue.gte`	string	No	筛选大于或等于该值。
`trading_venue.lt`	string	No	筛选小于该值。
`trading_venue.lte`	string	No	筛选小于或等于该值。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 10，允许的最大值为 1000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 product_code，排序方向默认为 asc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].event`	string	指定交易日的时段类型。
`results[].product_code`	string	期货合约的产品代码。
`results[].product_name`	string	该时刻表适用的期货产品名称。
`results[].session_end_date`	string	交易时刻表的时段结束日期（也称交易日）。该字段可选，可用于按特定时段结束日期筛选结果。留空则返回所有日期的时刻表。注意交易时段在美国中部时间下午 5 点结束，因此中部时间 1 月 1 日下午 5 点结束的时段，其 session_end_date 为 2025-01-01。
`results[].timestamp`	string	指定市场事件的时间戳。
`results[].trading_venue`	string	该时间表对应产品所属交易所的交易场所（MIC）。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.staging.massive.com/futures/v2/schedules?cursor=AQANA0VSTAIAAAEFAAEBAwACAQ0DRVJMAQ0ZMjAyNC0wNi0xMFQyMTowMDowMCswMDowMA==",
  "request_id": "a83620d1ec6a4cd5b84ea669e377fd47",
  "results": [
    {
      "event": "pre_open",
      "product_code": "ERL",
      "product_name": "ERCOT North 345 kV Hub Day-Ahead 5 MW Off-Peak Futures",
      "session_end_date": "2024-06-10",
      "timestamp": "2024-06-09T21:00:00+00:00",
      "trading_venue": "XNYM"
    },
    {
      "event": "open",
      "product_code": "ERL",
      "product_name": "ERCOT North 345 kV Hub Day-Ahead 5 MW Off-Peak Futures",
      "session_end_date": "2024-06-10",
      "timestamp": "2024-06-09T22:00:00+00:00",
      "trading_venue": "XNYM"
    },
    {
      "event": "close",
      "product_code": "ERL",
      "product_name": "ERCOT North 345 kV Hub Day-Ahead 5 MW Off-Peak Futures",
      "session_end_date": "2024-06-10",
      "timestamp": "2024-06-10T21:00:00+00:00",
      "trading_venue": "XNYM"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

期货 交易时间表 · REST 接口

适用场景

查询参数

响应字段

响应示例

期货交易时间表 · REST 接口