Historical K-Line

K-line (Candlestick) Data

curl --request GET \
  --url https://api.tickdb.ai/v1/market/kline \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/market/kline', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tickdb.ai/v1/market/kline",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tickdb.ai/v1/market/kline"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/market/kline")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "700.HK",
    "interval": "1h",
    "klines": [
      {
        "time": 1773291600000,
        "open": "545.5",
        "high": "546.5",
        "low": "541.5",
        "close": "543.5",
        "volume": "1549300",
        "quote_volume": "842560983.33"
      }
    ]
  }
}

GET

market

kline

K-line (Candlestick) Data

curl --request GET \
  --url https://api.tickdb.ai/v1/market/kline \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.tickdb.ai/v1/market/kline', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tickdb.ai/v1/market/kline",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tickdb.ai/v1/market/kline"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tickdb.ai/v1/market/kline")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "code": 0,
  "message": "success",
  "data": {
    "symbol": "700.HK",
    "interval": "1h",
    "klines": [
      {
        "time": 1773291600000,
        "open": "545.5",
        "high": "546.5",
        "low": "541.5",
        "close": "543.5",
        "volume": "1549300",
        "quote_volume": "842560983.33"
      }
    ]
  }
}

Notes

This endpoint returns historical K-line data for completed periods, data is fixed and will not change
Suitable for strategy backtesting, technical indicator calculation, and data archiving
For real-time K-line data in the current period, use Real-time K-Line: /v1/market/kline/latest

Supported Markets

Forex, Metals, Indices, US Stocks, HK Stocks, A-Shares, China Futures, Crypto Examples:

Forex: EURUSD, GBPUSD, USDJPY
Metals: XAUUSD, XAGUSD
Indices: SPX, NDX, DJI
US Stocks: AAPL.US, TSLA.US, MSFT.US
HK Stocks: 700.HK, 9988.HK, 3690.HK
A-Shares: 600519.SH, 000001.SZ, 920186.BJ
China Futures: BU2609, IC2606, AP8888
Crypto: BTCUSDT, ETHUSDT, ADAUSDT

Request Parameters

Parameter	Required	Description
symbol	Yes	Trading symbol code
interval	Yes	K-line period, options: 1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M
limit	No	Number of records, default 100, max 1000
start_time	No	Start timestamp (milliseconds)
end_time	No	End timestamp (milliseconds)
type	No	Symbol type, optional. Not required when the symbol is unambiguous; if the API returns an `AMBIGUOUS_SYMBOL` error, pass the value as indicated. Values: `stock`, `indices`, `crypto`, `forex`, `futures`

Response Fields

Field	Description
symbol	Trading Symbol
type	Product type
interval	K-line period
klines	K-line data array
└─ time	K-line timestamp (milliseconds)
└─ open	Opening price
└─ high	Highest price
└─ low	Lowest price
└─ close	Closing price
└─ volume	Trading volume
└─ quote_volume	Trading amount; normally omitted for futures
└─ open_interest	Open interest; returned for futures

Authorizations

X-API-Key

string

header

required

Query Parameters

symbol

string

default:700.HK

required

Trading symbol

Example:

"700.HK"

interval

enum<string>

default:1h

required

K-line interval

Available options:

1m,

5m,

15m,

30m,

1h,

2h,

4h,

1d,

1w,

1M

Example:

"1h"

limit

integer

Number of records (default 100, max 1000)

Required range: 1 <= x <= 1000

Example:

100

start_time

integer

Start timestamp in milliseconds

Example:

1703123456789

end_time

integer

End timestamp in milliseconds

Example:

1703209856789

type

enum<string>

Symbol type, optional. Not required when the symbol is unambiguous; if the API returns an AMBIGUOUS_SYMBOL error, pass the value as indicated

Available options:

stock,

indices,

crypto,

forex,

futures

Example:

"stock"

Response

200 - application/json

Successful response

code

integer

Example:

0

message

string

Example:

"success"

data

object

Show child attributes

Introduction

Getting Started

REST API

WebSocket Docs

Reference

Notes

Supported Markets

Request Parameters

Response Fields

Authorizations

Query Parameters

Response

​Notes

​Supported Markets

​Request Parameters

​Response Fields

Authorizations

Query Parameters

Response

Notes

Supported Markets

Request Parameters

Response Fields