期货 市场状态 · REST 接口
期货市场状态。获取指定产品的当前市场状态,返回开市、暂停、收市等实时指示,并附带交易所与产品代码及评估时间戳,便于据此调整交易策略。
GET /futures/v1/market-status上游时效说明
实时更新
上游历史范围
该接口不适用
适用场景
- 实时监控、算法调度、界面更新、运维规划。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
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 | 筛选小于或等于该值。 |
limit | integer | No | 限制返回结果的最大数量。未指定时默认为 10,允许的最大值为 100。 |
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
next_url | string | 若存在,可用该值获取下一页数据。 |
request_id | string | 服务器分配的请求 ID。 |
results | array[object] | 本次请求的结果。 |
results[].market_event | string | 该产品所属市场的当前状态。 |
results[].name | string | 期货产品名称。 |
results[].product_code | string | 要查询状态的期货合约产品代码。 |
results[].session_end_date | string | 当前时段的交易日。 |
results[].timestamp | string | 指定市场事件的时间戳。 |
results[].trading_venue | string | 对应产品挂牌交易所的交易场所代码(MIC)。 |
status | enum: 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 文档 ↗