期货合约信息
POST/api/v1.0/quote/future-info批量获取期货合约的基本静态信息,包含合约规模、报价单位、最小变动价位、交易时段、交割方式等合约属性。仅返回静态合约属性,不含报价、K 线、持仓量等行情数据。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
code_list | string[] | 请求体 | 是 | 期货合约代码列表,单次最多 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[],每元素一个合约信息:
| 参数 | 类型 | 说明 |
|---|---|---|
data | object | |
data.future_info_list | object[] | |
data.future_info_list[].code | string | 合约代码,例: HK.HSImain |
data.future_info_list[].name | string | 合约名称,例: HSI Futures (MAY6) |
data.future_info_list[].owner | string | 标的代码或品种代码,例: HK.800000 |
data.future_info_list[].exchange | string | 交易所简称,例: HKEX / CME / SGX |
data.future_info_list[].type | string | 合约类型,例: Equity Index / Currency / Energy / Metals |
data.future_info_list[].size | number | 合约规模(数值部分),例: 50 |
data.future_info_list[].size_unit | string | 合约规模单位,例: Index Points×HKD |
data.future_info_list[].price_currency | number | 报价货币,例: HKD / USD |
data.future_info_list[].price_unit | string | 报价单位,例: Index Point |
data.future_info_list[].min_change | number | 最小变动价位(数值部分),例: 1 |
data.future_info_list[].min_change_unit | string | 最小变动价位单位,例: Index Point |
data.future_info_list[].trade_time | string | 交易时段(按交易日各时段拼接),例: (09:15 - 12:00), (13:00 - 16:30), (17:15 - 03:00) |
data.future_info_list[].time_zone | int | 交易所时区简称,例: CCT(中国标准时间)/ EST |
data.future_info_list[].last_trade_time | int | 最后交易时间,毫秒时间戳;主连/连续合约为 0 |
data.future_info_list[].exchange_format_url | string | 交易所合约规则页 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_type | string | 交割方式:UNKNOWN(未知)/ PHYSICAL(实物交割)/ CASH(现金交割) |
pagination | object | 部分接口返回分页信息 |
限制范围
- 支持的市场: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 | 服务错误 | 重试;若持续失败联系技术支持 |
响应示例
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"
}
]
}
}