Skip to content

期货合约信息 ​

POST /api/v1.0/quote/future-info

批量获取期货合约的基本静态信息,包含合约规模、报价单位、最小变动价位、交易时段、交割方式等合约属性。仅返回静态合约属性,不含报价、K 线、持仓量等行情数据。

请求参数 ​

参数类型位置必填说明
code_liststring[]请求体是期货合约代码列表,单次最多 400 个;例 ["HK.HSImain", "US.CLmain"]。

请求示例 ​

bash
curl -X POST 'https://webapi.futunn.com/api/v1.0/quote/future-info' \
  -H 'Content-Type: application/json' \
  -d '{"code_list":["HK.HSImain","US.CLmain"]}' | jq

响应字段 ​

返回 data.future_info_list[],每元素一个合约信息:

参数类型说明
dataobject
data.future_info_listobject[]
data.future_info_list[].codestring合约代码,例: HK.HSImain
data.future_info_list[].namestring合约名称,例: HSI Futures (MAY6)
data.future_info_list[].ownerstring标的代码或品种代码,例: HK.800000
data.future_info_list[].exchangestring交易所简称,例: HKEX / CME / SGX
data.future_info_list[].typestring合约类型,例: Equity Index / Currency / Energy / Metals
data.future_info_list[].sizenumber合约规模(数值部分),例: 50
data.future_info_list[].size_unitstring合约规模单位,例: Index Points×HKD
data.future_info_list[].price_currencynumber报价货币,例: HKD / USD
data.future_info_list[].price_unitstring报价单位,例: Index Point
data.future_info_list[].min_changenumber最小变动价位(数值部分),例: 1
data.future_info_list[].min_change_unitstring最小变动价位单位,例: Index Point
data.future_info_list[].trade_timestring交易时段(按交易日各时段拼接),例: (09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00)
data.future_info_list[].time_zoneint交易所时区简称,例: CCT(中国标准时间)/ EST
data.future_info_list[].last_trade_timeint最后交易时间,毫秒时间戳;主连/连续合约为 0
data.future_info_list[].exchange_format_urlstring交易所合约规则页 URL,例: https://www.hkex.com.hk/Products/Listed-Derivatives/Equity-Index/Hang-Seng-Index-(HSI)/Hang-Seng-Index-Futures?sc_lang=en#&product=HSI
data.future_info_list[].delivery_typestring交割方式:UNKNOWN(未知)/ PHYSICAL(实物交割)/ CASH(现金交割)
paginationobject部分接口返回分页信息

限制范围 ​

  • 支持的市场:HK / US / SG / JP(覆盖 HKEX、CME 集团、SGX、OSE 等主要期货交易所)。
  • 支持的品类:仅期货合约,包括主连/连续合约(代码以 main 结尾)和月份合约(带具体年月)。
  • 不支持的输入(正股 / ETF / 指数 / 期权 / 窝轮等)会被静默丢弃,调用方应通过返回列表中的 code 字段对照入参判断哪些 code 未被识别。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功(包括所有 code 被静默丢弃时返回空数组)检查 future_info_list 长度,对照 code 字段判断哪些 code 未被识别
-3invalid_parametercode_list 缺失 / 为空 / 超过 400 项修正入参后重试
其他负数internal_error服务错误重试;若持续失败联系技术支持

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "future_info_list": [
      {
        "code": "HK.HSImain",
        "name": "HSI Futures (JUN6)",
        "owner": "HK.800000",
        "exchange": "HKEX",
        "type": "Equity Index",
        "size": 50,
        "size_unit": "Index Points×HKD",
        "price_currency": 0,
        "price_unit": "Index Point",
        "min_change": 1,
        "min_change_unit": "Index Point",
        "trade_time": "(09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00)",
        "time_zone": 0,
        "last_trade_time": 0,
        "exchange_format_url": "https://www.hkex.com.hk/...HSI...",
        "delivery_type": "PHYSICAL"
      },
      {
        "code": "US.CLmain",
        "name": "Crude Oil Futures (JUL6)",
        "owner": "Crude Oil",
        "exchange": "NYMEX",
        "type": "Energy",
        "size": 1000,
        "size_unit": "barrels",
        "price_currency": 0,
        "price_unit": "Quote*1000 USD",
        "min_change": 0.01,
        "min_change_unit": "USD/barrels",
        "trade_time": "(18:00(T-1) - 17:00)",
        "time_zone": 0,
        "last_trade_time": 0,
        "exchange_format_url": "https://www.cmegroup.com/...crude-oil...",
        "delivery_type": "PHYSICAL"
      }
    ]
  }
}