POST 批量查询产品最新2根K线（最高、最低、开盘、收盘价）

English / 中文

POST /batch-kline

接口说明

该接口可以一次性批量查询多个产品，且可批量一次性查询多个k线类型（k线类型指的是1分钟，15分钟，30分钟等），但只能批量查询最新的2根k线。

使用HTTP接口获取K线的客户，建议将/kline和/batch-kline这2个接口结合使用,步骤如下：

• 首先，通过 /kline 接口轮询请求历史数据并存储到本地数据库，后续历史数据可直接从客户的数据库获取，无需再通过接口请求。

• 然后，后续持续使用 /batch-kline 接口批量请求多个产品的最新2根K线，并将数据更新到数据库。

这种方式能够快速更新最新的K线，同时避免频繁请求历史K线造成频率受到限制。

请求频率

计划	单独请求	同时请求多个http接口
免费	1、每10秒，可1次请求 2、每次可批量查询10组数据，每1组数据=1只产品数量+1种K线类型，例如同时获取BTCUSDT的1分钟k线和5分钟k线，这就是2组数据	1、同1秒只能请求1个口 2、所有接口相加，1分钟最大请求10次(6秒1次) 3、需注意/batch-kline接口需间隔10秒 4、每天总共最大可请求14400次，超过则第二天凌晨恢复使用
基础	1、每3秒，只能1次请求 2、每次可批量查询100组数据，每1组数据=1只产品数量+1种K线类型，例如同时获取BTCUSDT的1分钟k线和5分钟k线，这就是2组数据	1、同1秒只能请求1个接口 2、所有接口相加，1分钟最大请求60次(1秒1次) 3、需注意/batch-kline接口需间隔3秒 4、每天总共最大可请求86400次，超过则第二天凌晨恢复使用
高级	1、每2秒，只能1次请求 2、每次可批量查询200组数据，每1组数据=1只产品数量+1种K线类型，例如同时获取BTCUSDT的1分钟k线和5分钟k线，这就是2组数据	1、所有接口相加，1分钟最大请求600次(1秒10次) 2、需注意/batch-kline接口需间隔2秒 3、每天总共最大可请求864000次，超过则第二天凌晨恢复使用
专业	1、每1秒，只能1次请求 2、每次可批量查询500组数据，每1组数据=1只产品数量+1种K线类型，例如同时获取BTCUSDT的1分钟k线和5分钟k线，这就是2组数据	1、所有接口相加，1分钟最大请求1200次(1秒20次) 2、需注意/batch-kline接口需间隔1秒 3、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用
全部港股	1、每1秒，只能1次请求 2、每次可批量查询500组数据，每1组数据=1只产品数量+1种K线类型，例如同时获取BTCUSDT的1分钟k线和5分钟k线，这就是2组数据	1、所有接口相加，1分钟最大请求1200次(1秒20次) 2、需注意/batch-kline接口需间隔1秒 3、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用
全部A股	1、每1秒，只能1次请求 2、每次可批量查询500组数据，每1组数据=1只产品数量+1种K线类型，例如同时获取BTCUSDT的1分钟k线和5分钟k线，这就是2组数据	1、所有接口相加，1分钟最大请求1200次(1秒20次) 2、需注意/batch-kline接口需间隔1秒 3、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用
全部美股	1、每1秒，只能1次请求 2、每次可批量查询500组数据，每1组数据=1只产品数量+1种K线类型，例如同时获取BTCUSDT的1分钟k线和5分钟k线，这就是2组数据	1、所有接口相加，1分钟最大请求1200次(1秒20次) 2、需注意/batch-kline接口需间隔1秒 3、每天总共最大可请求1728000次，超过则第二天凌晨恢复使用

接口限制

1、请务必阅读：HTTP接口限制说明

2、请务必阅读：错误码说明

接口地址

1、美股、港股、A股、大盘数据接口地址：

• 基本路径: /quote-stock-b-api/batch-kline

• 完整URL: https://quote.alltick.io/quote-stock-b-api/batch-kline

2、外汇、贵金属、加密货币、原油、CFD指数、商品接口地址：

• 基本路径: /quote-b-api/batch-kline

• 完整URL: https://quote.alltick.io/quote-b-api/batch-kline

请求示例

1、美股、港股、A股、大盘数据请求示例：

批量查询产品最新K线功能，由于批量查询参数比较多，放入body中，url参数中只保留token字段参数。 在发送查询请求时，必须包含方法名和token信息。一个请求的示例如下： https://quote.alltick.io/quote-stock-b-api/batch-kline?token=您的token

2、外汇、贵金属、加密货币、原油、CFD指数、商品请求示例：

批量查询产品最新K线功能，由于批量查询参数比较多，放入body中，url参数中只保留token字段参数。 在发送查询请求时，必须包含方法名和token信息。一个请求的示例如下： https://quote.alltick.io/quote-b-api/batch-kline?token=您的token

批量查询产品最新K线功能，由于批量查询参数比较多，放入body中，url参数中只保留token字段参数。

Body 请求参数

{
  "trace": "c2a8a146-a647-4d6f-ac07-8c4805bf0b74",
  "data": {
    "data_list": [
      {
        "code": "700.HK",
        "kline_type": 1,
        "kline_timestamp_end": 0,
        "query_kline_num": 1,
        "adjust_type": 0
      },
      {
        "code": "GOOGL.US",
        "kline_type": 1,
        "kline_timestamp_end": 0,
        "query_kline_num": 1,
        "adjust_type": 0
      }
    ]
  }
}

请求参数

名称	位置	类型	必选	说明
token	query	string	是	如果不知道你的token，请联系相关人员索要
body	body	object	否
» trace	body	string	是	追踪码，用来查询日志使用，请保证每次请求时唯一
» data	body	object	是
»» data_list	body	[object]	是
»»» code	body	string	是	请查看code列表，选择你要查询的code：[点击code列表]
»»» kline_type	body	integer	是	k线类型 1、1是1分钟K，2是5分钟K，3是15分钟K，4是30分钟K，5是小时K，6是2小时K(股票不支持2小时)，7是4小时K(股票不支持4小时)，8是日K，9是周K，10是月K （注：股票不支持2小时K、4小时K） 2、最短的k线只支持1分钟 3、查询昨日收盘价，kline_type 传8
»»» kline_timestamp_end	body	integer	是	从指定时间往前查询K线 1、传0表示从当前最新的交易日往前查k线 2、指定时间请传时间戳，传时间戳表示从该时间戳往前查k线 3、只有外汇贵金属加密货币支持传时间戳，股票类的code不支持
»»» query_kline_num	body	integer	是	1、表示查询多少根K线，该接口最大只能查询2根k线 2、通过该字段可查询昨日收盘价，kline_type 传8，query_kline_num传2，返回2根k线数据中，时间戳较小的数据是昨日收盘价
»»» adjust_type	body	integer	是	复权类型,对于股票类的code才有效，例如：0:除权,1:前复权，目前仅支持0

返回示例

{
  "ret": 200,
  "msg": "ok",
  "trace": "c2a8a146-a647-4d6f-ac07-8c4805bf0b74",
  "data": {
    "kline_list": [
      {
        "code": "700.HK",
        "kline_type": 1,
        "kline_data": [
          {
            "timestamp": "1677829200",
            "open_price": "136.421",
            "close_price": "136.412",
            "high_price": "136.422",
            "low_price": "136.407",
            "volume": "0",
            "turnover": "0"
          }
        ]
      },
      {
        "code": "GOOGL.US",
        "kline_type": 1,
        "kline_data": [
          {
            "timestamp": "1677829200",
            "open_price": "136.421",
            "close_price": "136.412",
            "high_price": "136.422",
            "low_price": "136.407",
            "volume": "0",
            "turnover": "0"
          }
        ]
      }
    ]
  }
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	OK	Inline

名称	类型	必选	说明
» ret	integer	true
» msg	string	true
» trace	string	true
» data	object	true
»» kline_list	[array]	true
»»» code	string	true	产品代码
»»» kline_type	integer	true	k线类型 1、1是1分钟K，2是5分钟K，3是15分钟K，4是30分钟K，5是小时K，6是2小时K(股票不支持2小时)，7是4小时K(股票不支持4小时)，8是日K，9是周K，10是月K （注：股票不支持2小时K、4小时K） 2、最短的k线只支持1分钟
»»» kline_data	[array]	true
»»»» timestamp	string	true	该K线时间戳
»»»» open_price	string	true	该K线开盘价
»»»» close_price	string	true	该K线收盘价
»»»» high_price	string	true	该K线最高价
»»»» low_price	string	true	该K线最低价
»»»» volume	string	true	该K线成交数量
»»»» turnover	string	true	该K线成交金额

批量K线查询

post

查询参数

tokenstring必填

如果不知道你的token，请联系相关人员索要

请求体

tracestring必填

追踪码，用来查询日志使用，请保证每次请求时唯一

响应

200

OK

application/json

post

HTTPcURLJavaScriptPython

POST /quote-stock-b-api/batch-kline HTTP/1.1
Host: quote.alltick.io
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "trace": "text",
  "data": {
    "data_list": [
      {
        "code": "text",
        "kline_type": 1,
        "kline_timestamp_end": 1,
        "query_kline_num": 1,
        "adjust_type": 1
      }
    ]
  }
}

200

OK

{
  "ret": 1,
  "msg": "text",
  "trace": "text",
  "data": {
    "kline_list": [
      {
        "code": "text",
        "kline_type": 1,
        "kline_data": [
          {
            "timestamp": "text",
            "open_price": "text",
            "close_price": "text",
            "high_price": "text",
            "low_price": "text",
            "volume": "text",
            "turnover": "text"
          }
        ]
      }
    ]
  }
}

AllTick网站

官方网站：https://alltick.co/