跳转到主要内容

​
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、10秒只能请求1个接口
2、所有接口相加，1分钟最大请求10次(6秒1次)
3、需注意/batch-kline接口需间隔10秒
4、每天总共最大可请求1000次，超过则第二天凌晨恢复使用
基础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股、大盘数据接口地址： 2、外汇、贵金属、加密货币、原油、CFD指数、商品接口地址：

​
请求示例

1、美股、港股、A股、大盘数据请求示例： 批量查询产品最新K线功能，由于批量查询参数比较多，放入body中，url参数中只保留token字段参数。
在发送查询请求时，必须包含方法名和token信息。一个请求的示例如下：
https://quote.alltick.co/quote-stock-b-api/batch-kline?token=您的token 2、外汇、贵金属、加密货币、原油、CFD指数、商品请求示例： 批量查询产品最新K线功能，由于批量查询参数比较多，放入body中，url参数中只保留token字段参数。
在发送查询请求时，必须包含方法名和token信息。一个请求的示例如下：
https://quote.alltick.co/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
      }
    ]
  }
}

​
请求参数

名称位置类型必选说明
tokenquerystring是如果不知道你的token，请联系相关人员索要
bodybodyobject否
» tracebodystring是追踪码，用来查询日志使用，请保证每次请求时唯一
» databodyobject是
»» data_listbody[object]是
»»» codebodystring是请查看code列表，选择你要查询的code：[点击code列表]
注意：code值大小写要与产品列表中的code保持一致
»»» kline_typebodyinteger是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_endbodyinteger是从指定时间往前查询K线
1、传0表示从当前最新的交易日往前查k线
2、指定时间请传时间戳，传时间戳表示从该时间戳往前查k线
3、只有外汇贵金属加密货币支持传时间戳，股票类的code不支持
»»» query_kline_numbodyinteger是1、表示查询多少根K线，该接口最大只能查询2根k线
2、通过该字段可查询昨日收盘价，kline_type 传8，query_kline_num传2，返回2根k线数据中，时间戳较小的数据是昨日收盘价
»»» adjust_typebodyinteger是复权类型,对于股票类的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"
          }
        ]
      }
    ]
  }
}

​
返回结果

状态码状态码含义说明数据模型
200OKOKInline
名称类型必选说明
» retintegertrue
» msgstringtrue
» tracestringtrue
» dataobjecttrue
»» kline_list[array]true
»»» codestringtrue产品代码
»»» kline_typeintegertruek线类型
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
»»»» timestampstringtrue该K线时间戳
»»»» open_pricestringtrue该K线开盘价
»»»» close_pricestringtrue该K线收盘价：
1、交易时段内，最新一根K线，该价格也是最新成交价
2、休市期间，最新一根K线，该价格是收盘价
»»»» high_pricestringtrue该K线最高价
»»»» low_pricestringtrue该K线最低价
»»»» volumestringtrue该K线成交数量
»»»» turnoverstringtrue该K线成交金额

​
AllTick网站

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

​
接口调试

打开 POST /batch-kline 调试模块

使用可调试模块填写参数并发送请求。