EasyFut

获取K线行情(隐性订阅)

GET /klines/{klines_symbol}

传参:

字段名类型是否必传字段说明
klines_symbolstr

K线标识,格式:{symbol}_{duration_seconds}_{data_length}

symbol(str): 指定合约代码

duration_seconds (int): K线数据周期, 以秒为单位。例如: 1分钟线为60,1小时线为3600,日线为86400。 注意: 周期在日线以内时此参数可以任意填写, 在日线以上时只能是日线(86400)的整数倍, 最大为28天 (86400*28)。

data_length (int): 需要获取的序列长度。 返回的K线序列数据是从当前最新一根K线开始往回取data_length根。 每个序列最大支持请求 8000 个数据

不传默认获取所有隐性订阅过的K线,支持多个,多个用英文逗号分割

示例:SHFE.rb2210_60_5

响应参数(参考TqSdk官方文档: http://doc.shinnytech.com/tqsdk/latest/reference/tqsdk.objs.html#tqsdk.objs.Kline)

字段名类型字段说明
datetimeintK线起点时间(按北京时间),自unix epoch(1970-01-01 00:00:00 GMT)以来的纳秒数
openfloatK线起始时刻的最新价
highfloatK线时间范围内的最高价
lowfloatK线时间范围内的最低价
closefloatK线结束时刻的最新价
volumeintK线时间范围内的成交量
open_oiintK线起始时刻的持仓量
close_oiintK线结束时刻的持仓量

请求示例:

curl http://127.0.0.1:8888/klines/SHFE.rb2210_60_5

响应示例:

{
  "code": 10000,
  "data": {
    "SHFE.rb2210_60_5": [{
      "datetime": 1.66385622e+18,
      "id": 79052.0,
      "open": 3946.0,
      "high": 3949.0,
      "low": 3945.0,
      "close": 3947.0,
      "volume": 338.0,
      "open_oi": 188350.0,
      "close_oi": 188185.0,
      "symbol": "SHFE.rb2210",
      "duration": 60
    }, {
      "datetime": 1.66385628e+18,
      "id": 79053.0,
      "open": 3947.0,
      "high": 3950.0,
      "low": 3947.0,
      "close": 3949.0,
      "volume": 297.0,
      "open_oi": 188185.0,
      "close_oi": 187991.0,
      "symbol": "SHFE.rb2210",
      "duration": 60
    }, {
      "datetime": 1.66385634e+18,
      "id": 79054.0,
      "open": 3949.0,
      "high": 3949.0,
      "low": 3946.0,
      "close": 3947.0,
      "volume": 94.0,
      "open_oi": 187991.0,
      "close_oi": 187942.0,
      "symbol": "SHFE.rb2210",
      "duration": 60
    }, {
      "datetime": 1.6638564e+18,
      "id": 79055.0,
      "open": 3947.0,
      "high": 3948.0,
      "low": 3945.0,
      "close": 3948.0,
      "volume": 152.0,
      "open_oi": 187942.0,
      "close_oi": 187909.0,
      "symbol": "SHFE.rb2210",
      "duration": 60
    }, {
      "datetime": 1.66385646e+18,
      "id": 79056.0,
      "open": 3948.0,
      "high": 3948.0,
      "low": 3948.0,
      "close": 3948.0,
      "volume": 0.0,
      "open_oi": 187909.0,
      "close_oi": 187909.0,
      "symbol": "SHFE.rb2210",
      "duration": 60
    }]
  },
  "msg": "操作成功!"
}