REST 接口 · 文档目录

期货 市场状态 · REST 接口

期货市场状态。获取指定产品的当前市场状态,返回开市、暂停、收市等实时指示,并附带交易所与产品代码及评估时间戳,便于据此调整交易策略。

GET /futures/v1/market-status
上游时效说明

实时更新

上游历史范围

该接口不适用

适用场景

  • 实时监控、算法调度、界面更新、运维规划。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
product_codestringNo要查询状态的期货合约产品代码。
product_code.any_ofstringNo筛选等于任一给定值。多个值可用逗号分隔的列表指定。
product_code.gtstringNo筛选大于该值。
product_code.gtestringNo筛选大于或等于该值。
product_code.ltstringNo筛选小于该值。
product_code.ltestringNo筛选小于或等于该值。
limitintegerNo限制返回结果的最大数量。未指定时默认为 10,允许的最大值为 100。

响应字段

字段类型说明
next_urlstring若存在,可用该值获取下一页数据。
request_idstring服务器分配的请求 ID。
resultsarray[object]本次请求的结果。
results[].market_eventstring该产品所属市场的当前状态。
results[].namestring期货产品名称。
results[].product_codestring要查询状态的期货合约产品代码。
results[].session_end_datestring当前时段的交易日。
results[].timestampstring指定市场事件的时间戳。
results[].trading_venuestring对应产品挂牌交易所的交易场所代码(MIC)。
statusenum: OK本次请求响应的状态。

响应示例

{
  "request_id": "445ebfcfe5bb4b688b7971e1600c952d",
  "results": [
    {
      "market_event": "open",
      "name": "ERCOT North 345 kV Hub Day-Ahead 5 MW Off-Peak Futures",
      "product_code": "ERL",
      "session_end_date": "2025-12-05",
      "timestamp": "2025-12-04T23:00:00+00:00",
      "trading_venue": "XNYM"
    }
  ],
  "status": "OK"
}

原文:Massive 文档 ↗