期货产品目录 · REST 接口

期货产品目录。统一提供全部受支持期货产品的检索与完整产品规格查询，返回产品代码、名称、交易所标识、板块与资产类别、产品类型、结算方式以及报价与定价细节。可按名称、交易所、板块、资产类别、产品类型或日期筛选，也可查询单个产品的完整规格，支持系统配置、分析、交易流程与历史对账。

GET /futures/v1/products

上游时效说明

每日更新

上游历史范围

数据可追溯至 2017 年 4 月 3 日

适用场景

产品规格查询、历史产品核查、风险管理、交易系统集成。

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

查询参数

参数	类型	必填	说明
`name`	string	No	产品全称。
`name.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`name.gt`	string	No	筛选大于该值。
`name.gte`	string	No	筛选大于或等于该值。
`name.lt`	string	No	筛选小于该值。
`name.lte`	string	No	筛选小于或等于该值。
`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	筛选小于或等于该值。
`date`	string	No	YYYY-MM-DD 格式的日期字符串。该参数返回指定日期产品的时点信息。取值必须为 yyyy-mm-dd 格式。
`date.gt`	string	No	筛选大于该值。值格式须为 yyyy-mm-dd。
`date.gte`	string	No	筛选大于或等于该值。值格式须为 yyyy-mm-dd。
`date.lt`	string	No	筛选小于该值。值格式须为 yyyy-mm-dd。
`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	筛选小于或等于该值。
`sector`	string	No	该产品所属板块。
`sector.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`sub_sector`	string	No	该产品所属细分板块。
`sub_sector.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`asset_class`	string	No	该产品所属资产类别。
`asset_class.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`asset_sub_class`	string	No	该产品所属资产子类别。
`asset_sub_class.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`type`	string	No	产品类型，取值为 single 或 combo。留空则同时查询 single 与 combo 两种类型。
`type.any_of`	string	No	筛选等于任一给定值。多个值可用逗号分隔的列表指定。
`limit`	integer	No	限制返回结果的最大数量。未指定时默认为 100，允许的最大值为 50000。
`sort`	string	No	逗号分隔的排序列列表。每列可追加 .asc 或 .desc 指定排序方向。未指定时排序列默认为 date，排序方向默认为 asc。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	本次请求的结果。
`results[].asset_class`	string	该产品所属资产类别。
`results[].asset_sub_class`	string	该产品所属资产子类别。
`results[].date`	string	YYYY-MM-DD 格式的日期字符串。该参数返回指定日期产品的时点信息。
`results[].last_updated`	string	该产品最近一次更新的日期与时间。
`results[].name`	string	产品全称。
`results[].price_quotation`	string	该产品的报价。
`results[].product_code`	string	产品的标识。
`results[].sector`	string	该产品所属板块。
`results[].settlement_currency_code`	string	该产品的结算货币。
`results[].settlement_method`	string	该产品的结算方式（现金结算或实物交割）。
`results[].settlement_type`	string	该产品的结算类型。
`results[].sub_sector`	string	该产品所属细分板块。
`results[].trade_currency_code`	string	该产品合约的交易货币。
`results[].trading_venue`	string	该产品合约所属交易所的交易场所（MIC）。
`results[].type`	string	产品类型，取值为 single 或 combo。留空则同时查询 single 与 combo 两种类型。
`results[].unit_of_measure`	string	该产品的计量单位。
`results[].unit_of_measure_qty`	number	该产品的计量单位数量。
`status`	enum: OK	本次请求响应的状态。

响应示例

{
  "next_url": "https://api.massive.com/futures/v1/products?cursor=YXA9MTAwJmFzPSZhc19vZj0yMDI1LTA3LTA3JmxpbWl0PTEwMCZzb3J0PW5hbWUuYXNj",
  "request_id": "000a000a0a0a000a0a0aa00a0a0000a0",
  "results": [
    {
      "asset_class": "commodity",
      "asset_sub_class": "energy",
      "date": "2025-07-07",
      "last_updated": "2025-02-22",
      "name": "1% Fuel Oil Barges FOB Rdam (Platts) vs. 1% Fuel Oil Cargoes FOB NWE (Platts) BALMO Futures",
      "price_quotation": "U.S. dollars and cents per metric ton",
      "product_code": "EBE",
      "sector": "refined_products",
      "settlement_currency_code": "USD",
      "settlement_method": "financially_settled",
      "settlement_type": "cash",
      "sub_sector": "european",
      "trade_currency_code": "USD",
      "trading_venue": "XNYM",
      "type": "single",
      "unit_of_measure": "MTONS",
      "unit_of_measure_qty": 1000
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

期货 产品目录 · REST 接口

适用场景

查询参数

响应字段

响应示例

期货产品目录 · REST 接口