期货数据接口
期货与衍生品
覆盖中金所股指期货(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 线。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | ✓ | 品种代码 (IF / IC / IM / IH) |
start_date | string | - | 开始日期 (YYYY-MM-DD) |
end_date | string | - | 结束日期 (YYYY-MM-DD) |
limit | int | - | 返回条数 (默认 500) |
响应包含 open、high、low、close、settle (结算价)、volume、open_interest (持仓量)。
GET
/v1/futures/index/history2. 商品期货 K 线
| 方法 | 端点 |
|---|---|
| GET | /v1/futures/commodity/history |
获取商品期货(RB 螺纹钢 / SC 原油 / AU 黄金 / AG 白银 / CU 铜 / AL 铝 / HC 热卷 / FU 燃油 / M 豆粕 / RM 菜粕 / CF 棉花 / SR 白糖)主力连续日 K 线。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | ✓ | 品种代码 (RB / SC / AU / CU / AL / AG / HC / FU / M / RM / CF / SR) |
start_date | string | - | 开始日期 (YYYY-MM-DD) |
end_date | string | - | 结束日期 (YYYY-MM-DD) |
limit | int | - | 返回条数 (默认 500) |
GET
/v1/futures/commodity/history3. 股指期货快照
| 方法 | 端点 |
|---|---|
| GET | /v1/futures/index/snapshot |
获取指定股指期货品种的最新(或截止某日)报价、持仓量与基差占位字段。basis、basis_pct、underlying_index 在现货指数数据可用时填充,否则为 null。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | ✓ | 品种代码 (IF / IC / IM / IH) |
date | string | - | 截止日期 (YYYY-MM-DD);不填则返回最新可用数据 |
GET
/v1/futures/index/snapshot4. 品种列表
| 方法 | 端点 |
|---|---|
| GET | /v1/futures/symbols |
返回所有可用的期货品种、交易所、资产类别与中文名称,便于客户端动态构建品种选择器。
GET
/v1/futures/symbols