AllTick.co
  1. AllTick APIs
AllTick.co
  • AllTick APIs
    • GET 最新盘口报价查询
      GET
    • GET 最新成交报价查询
      GET
    • GET K线查询
      GET
    • POST 批量查询产品最新K线
      POST
  1. AllTick APIs

POST 批量查询产品最新K线

开发中
POST
/batch-kline

POST 批量查询产品最新K线#

POST /batch-kline
完整的URL请参见API地址说明

批量查询产品最新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
»»» kline_typebodyinteger是k线类型,1分钟K,2为5分钟K,3为15分钟K,4为30分钟K,5为小时K,6为2小时K,7为4小时K,8为日K,9为周K,10为月K(注:股票不支持2小时K、4小时K)
»»» kline_timestamp_endbodyinteger是从那个时间点往前查,为0表示从当前时间,非股票类的code才有效
»»» query_kline_numbodyinteger是查询多少根K线,只能查询最新1或者2根
»»» adjust_typebodyinteger是复权类型,对于股票类的code才有效,例如:0:除权,1:前复权
返回示例
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"
          }
        ]
      }
    ]
  }
}

返回结果#

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

返回数据结构#

状态码 200
名称类型必选约束中文名说明
» retintegertrue
» msgstringtrue
» tracestringtrue
» dataobjecttrue
»» kline_list[array]true
»»» codestringtrue产品代码
»»» kline_typeintegertruek线类型,1分钟K,2为5分钟K,3为15分钟K,4为30分钟K,5为小时K,6为2小时K,7为4小时K,8为日K,9为周K,10为月K(注:股票不支持2小时K、4小时K)
»»» kline_data[array]true
»»»» timestampstringtrue该K线时间戳
»»»» open_pricestringtrue该K线开盘价
»»»» close_pricestringtrue该K线收盘价
»»»» high_pricestringtrue该K线最高价
»»»» low_pricestringtrue该K线最低价
»»»» volumestringtrue该K线成交数量
»»»» turnoverstringtrue该K线成交金额

请求参数

Query 参数
token
string 
可选
示例值:
aaaaaaaaaaaaaaaaa-c-app
Body 参数application/json
trace
string 
必需
data
object 
必需
data_list
array [object {5}] 
必需
示例
{
  "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
      }
    ]
  }
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/batch-kline?token=aaaaaaaaaaaaaaaaa-c-app' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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
      }
    ]
  }
}'

返回响应

🟢200Success
application/json
Body
ret
integer 
必需
msg
string 
必需
trace
string 
必需
data
object 
必需
kline_list
array [object {3}] 
必需
示例
{
  "ret": 0,
  "msg": "string",
  "trace": "string",
  "data": {
    "kline_list": [
      {
        "code": "string",
        "kline_type": 0,
        "kline_data": [
          {
            "timestamp": "string",
            "open_price": "string",
            "close_price": "string",
            "high_price": "string",
            "low_price": "string",
            "volume": "string",
            "turnover": "string"
          }
        ]
      }
    ]
  }
}
修改于 2024-09-25 09:02:32
上一页
GET K线查询
Built with