期货合约信息

POST /v1/quote/future-info

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

请求参数

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

请求示例

curl -X POST '$ip/v1/quote/future-info' \
  -H 'Content-Type: application/json' \
  -d '{"code_list":["HK.HSImain","US.CLmain"]}' | jq

响应字段

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

字段	类型	说明
code	string	合约代码，例 HK.HSImain。
name	string	合约名称，例 HSI Futures (JUN6)。
owner	string	标的代码或品种代码（指数期货为指数代码，商品期货为品种名）。
exchange	string	交易所简称：HKEX / CME / CBOT / NYMEX / COMEX / CBOE / SGX / OSE。
type	string	合约类型：Equity Index / Single Stock / Metals / Energy / Agricultural / Interest Rates / Cryptocurrency / FX。
size	float	合约规模数值。
size_unit	string	合约规模单位，例 Index Points×HKD、barrels。
price_currency	string	报价货币：HKD / USD / CNH / SGD / JPY。
price_unit	string	报价单位，例 Index Point、Quote*1000 USD。
min_change	float	最小变动价位数值。
min_change_unit	string	最小变动价位单位，例 Index Point、USD/barrels。
trade_time	string	交易时段，例 (09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00)。(T-1) 表示前一交易日。
time_zone	string	交易所时区简称：CCT / ET / CT / SGT / JST。
last_trade_time	int	最后交易时间（毫秒时间戳）；主连/连续合约固定为 0。
exchange_format_url	string	交易所合约规则页 URL。
delivery_type	string	交割方式：UNKNOWN / PHYSICAL / CASH。

限制范围

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

错误码

ret_code	error.code	触发条件	处理建议
0	—	成功（包括所有 code 被静默丢弃时返回空数组）	检查 future_info_list 长度，对照 code 字段判断哪些 code 未被识别
-3	invalid_parameter	code_list 缺失 / 为空 / 超过 400 项	修正入参后重试
其他负数	internal_error	网关或后端内部错误	重试；若持续失败联系网关侧

响应示例

{
  "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": "HKD",
        "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": "CCT",
        "last_trade_time": 0,
        "exchange_format_url": "https://www.hkex.com.hk/...HSI...",
        "delivery_type": "CASH"
      },
      {
        "code": "US.CLmain",
        "name": "Crude Oil Futures (JUL6)",
        "owner": "Crude Oil",
        "exchange": "NYMEX",
        "type": "Energy",
        "size": 1000,
        "size_unit": "barrels",
        "price_currency": "USD",
        "price_unit": "Quote*1000 USD",
        "min_change": 0.01,
        "min_change_unit": "USD/barrels",
        "trade_time": "(18:00(T-1) - 17:00)",
        "time_zone": "ET",
        "last_trade_time": 0,
        "exchange_format_url": "https://www.cmegroup.com/...crude-oil...",
        "delivery_type": "PHYSICAL"
      }
    ]
  }
}