Skip to content

Latest commit

 

History

History
158 lines (136 loc) · 7.86 KB

batch_kline_query_cn.md

File metadata and controls

158 lines (136 loc) · 7.86 KB

English | 中文

POST 批量查询产品最新K线

POST /batch-kline

完整的URL请参见API地址说明

接口说明

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

接口限制

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

接口地址

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

2、外汇、贵金属、加密货币、商品接口地址：

请求示例

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

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

2、外汇、贵金属、加密货币、商品请求示例：

批量查询产品最新K线功能，由于批量查询参数比较多，放入body中，url参数中只保留token字段参数。
在发送查询请求时，必须包含方法名和token信息。一个请求的示例如下：
https://quote.tradeswitcher.com/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
»»» kline_type body integer 是 k线类型
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）
最短的k线只支持1分钟
»»» kline_timestamp_end body integer 是 从指定时间往前查询K线
1、传0表示从当前最新的交易日往前查k线
2、指定时间请传时间戳，传时间戳表示从该时间戳往前查k线
3、只有外汇贵金属加密货币支持传时间戳，股票类的code不支持
»»» query_kline_num body integer 是 表示查询多少根K线，该接口最大只能查询2根k线
»»» adjust_type body integer 是 复权类型,对于股票类的code才有效，例如：0:除权,1:前复权，目前仅支持0

返回示例

OK

{
  "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

返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» 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是分钟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）
»»» 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线成交金额