Batch K-lines - AllTick API

Endpoint description

Batch query multiple products and K-line types (such as 1-minute, 15-minute, or 30-minute bars) in one request. Only the latest two bars can be retrieved.

POST /v1/batch-kline

Product type	Request URL
US stocks, Hong Kong stocks, A-shares, and major indices	`https://quote.alltick.co/quote-stock-b-api/v1/batch-kline`
Forex, precious metals, cryptocurrencies, crude oil, CFD indices, and commodities	`https://quote.alltick.co/quote-b-api/v1/batch-kline`

Request parameters

Parameter	Type	Required	Description
`X-API-Key`	string	Yes	Authentication token
`body`	string	Yes	Request content

body request content

{
  "trace": "c2a8a146-a647-4d6f-ac07-8c4805bf0b74",
  "data": {
    "symbol_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
      }
    ]
  }
}

Name	Type	Required	Description
`trace`	string	Yes	Unique trace ID for locating logs; use a distinct value for each request
`data`	object	Yes	Request data
`symbol_list`	array	Yes	List of products and K-line conditions
`code`	string	Yes	Product code; case must match the product list
`kline_type`	integer	Yes	K-line type; 1–10 represent 1-minute through monthly bars
`kline_timestamp_end`	integer	Yes	0 queries backward from the latest trading day
`query_kline_num`	integer	Yes	This endpoint retrieves at most two bars
`adjust_type`	integer	Yes	Stock adjustment type; only 0 is currently supported

Response example

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

Response fields

The response contains ret, msg, trace, and data.kline_list. Each item includes code, kline_type, and kline_data; each bar has timestamp, open_price, close_price, high_price, low_price, volume, and turnover.