期货数据接口

期货与衍生品

覆盖中金所股指期货(IF/IC/IM/IH)与上期所、能源中心、大商所、郑商所商品期货主力连续合约,每日 T+0 更新。

方法端点说明
GET/v1/futures/index/history股指期货 K 线
GET/v1/futures/commodity/history商品期货 K 线
GET/v1/futures/index/snapshot股指期货快照
GET/v1/futures/symbols品种列表

1. 股指期货 K 线

方法端点
GET/v1/futures/index/history

获取中金所股指期货(IF 沪深300 / IC 中证500 / IM 中证1000 / IH 上证50)主力连续日 K 线。

参数类型必填说明
symbolstring品种代码 (IF / IC / IM / IH)
start_datestring-开始日期 (YYYY-MM-DD)
end_datestring-结束日期 (YYYY-MM-DD)
limitint-返回条数 (默认 500)

响应包含 openhighlowclosesettle (结算价)、volumeopen_interest (持仓量)。

GET/v1/futures/index/history

2. 商品期货 K 线

方法端点
GET/v1/futures/commodity/history

获取商品期货(RB 螺纹钢 / SC 原油 / AU 黄金 / AG 白银 / CU 铜 / AL 铝 / HC 热卷 / FU 燃油 / M 豆粕 / RM 菜粕 / CF 棉花 / SR 白糖)主力连续日 K 线。

参数类型必填说明
symbolstring品种代码 (RB / SC / AU / CU / AL / AG / HC / FU / M / RM / CF / SR)
start_datestring-开始日期 (YYYY-MM-DD)
end_datestring-结束日期 (YYYY-MM-DD)
limitint-返回条数 (默认 500)
GET/v1/futures/commodity/history

3. 股指期货快照

方法端点
GET/v1/futures/index/snapshot

获取指定股指期货品种的最新(或截止某日)报价、持仓量与基差占位字段。basisbasis_pctunderlying_index 在现货指数数据可用时填充,否则为 null

参数类型必填说明
symbolstring品种代码 (IF / IC / IM / IH)
datestring-截止日期 (YYYY-MM-DD);不填则返回最新可用数据
GET/v1/futures/index/snapshot

4. 品种列表

方法端点
GET/v1/futures/symbols

返回所有可用的期货品种、交易所、资产类别与中文名称,便于客户端动态构建品种选择器。

GET/v1/futures/symbols