期货实时分钟K线
查询期货合约当前交易日截至请求时刻的实时 1 分钟 K 线。必填 --symbols,逗号分隔,1~20 个。
外部接口:GET /api/v4/market/data/futures_minutes/realtime。
| 项目 | 说明 |
|---|---|
| 输入参数 | symbols(必填):1~20 个合约代码;接口侧以逗号分隔发送,如 symbols=A2611.DCE,CU2611.SHFE,兼容旧的重复参数格式 |
| 响应结构 | code / message / data;data 为按请求顺序排列的分组数组,每项含 symbol、items、total |
| 分组字段 | symbol(请求中的合约代码)、items(该合约实时 1 分钟 K 线列表,按时间升序)、total(items 条数,无行情时为 0) |
| 每根 K 线字段 | bar_interval / symbol / variety / exchange / datetime / trade_date / open / high / low / close / volume / amount / vwap / open_interest / pre_settlement_price / settlement_price / high_limit_price / low_limit_price / pre_close_price / updated_at |
| 单次限量 | 一次支持 1~20 个合约;不提供 limit / start / end / 周期参数 |
所有请求必须设置环境变量 FTSHARE_API_KEY;handler 将其作为 FTSHARE_API_KEY 请求头发送。缺失凭据时不会发起请求。
通过主目录 run.py 调用:
python <RUN_PY> futures-realtime-minute-kline --symbols A2611.DCE,CU2611.SHFE
注意事项
- 交易所后缀规则(必读):合约代码格式为
<合约代码>.<交易所代码>,只接受交易所全称后缀.SHFE、.INE、.DCE、.CZCE、.CFFEX、.GFEX;短后缀.SHF、.CZC、.CFE、.GFE及其它未列出的后缀会返回 HTTP 400;无后缀的裸合约代码仍兼容。 - 不变参数:本接口固定返回当前交易日实时 1 分钟 K 线,不支持
limit、start、end或分钟周期参数,也不能指定历史日期。 - 外层分组的
symbol保留请求值;内层 K 线的symbol为去除交易所后缀并转小写后的合约代码。 - 每组的
total等于该组items的条数(不是分页总量)。 - 每个合约返回截至请求时刻的全部可用记录,结果按时间升序;无可用行情时该组
items为[]、total为 0。 - 历史分钟 K 线请使用
futures-minutes;实时日 K 线请使用futures-realtime-day-kline。