跳转到主要内容
GET
/
v1
/
market
/
kline
K-line (Candlestick) Data
curl --request GET \
  --url https://api.tickdb.ai/v1/market/kline \
  --header 'X-API-Key: <api-key>'
{
  "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"
      }
    ]
  }
}

​
注意事项

  • 本接口返回已结束周期的历史K线数据，数据已固定不会变化
  • 适用于策略回测、技术指标计算、数据归档存储
  • 若需获取当前周期内正在更新的K线，请使用实时K线：/v1/market/kline/latest

​
支持的市场

外汇、贵金属、指数、美股、港股、A股、加密货币 示例：
  • 外汇：EURUSD、GBPUSD、USDJPY
  • 贵金属：XAUUSD、XAGUSD
  • 指数：SPX、NDX、DJI
  • 美股：AAPL.US、TSLA.US、MSFT.US
  • 港股：700.HK、9988.HK、3690.HK
  • A股：600519.SH、000001.SZ、920186.BJ
  • 加密货币：BTCUSDT、ETHUSDT、ADAUSDT

​
请求参数

参数名是否必须描述
symbol是交易产品代码
interval是K线周期，可选值：1m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M
limit否返回记录数，默认100，最大1000
start_time否开始时间戳（毫秒）
end_time否结束时间戳（毫秒）
type否产品类型，可选。代码无歧义时无需传递；若返回 AMBIGUOUS_SYMBOL 错误，按提示传入对应值即可。可选值：stock、indices、crypto、forex

​
返回字段说明

字段说明
symbol交易产品
intervalK线周期
klinesK线数据数组
└─ timeK线时间戳（毫秒）
└─ open开盘价
└─ high最高价
└─ low最低价
└─ close收盘价
└─ volume成交量
└─ quote_volume成交额

授权

​
X-API-Key
string
header
必填

查询参数

​
symbol
string
默认值:700.HK
必填

Trading symbol

示例:

"700.HK"

​
interval
enum<string>
默认值:1h
必填

K-line interval

可用选项:
1m,
5m,
15m,
30m,
1h,
2h,
4h,
1d,
1w,
1M
示例:

"1h"

​
limit
integer

Number of records (default 100, max 1000)

必填范围: 1 <= x <= 1000
示例:

100

​
start_time
integer

Start timestamp in milliseconds

示例:

1703123456789

​
end_time
integer

End timestamp in milliseconds

示例:

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

可用选项:
stock,
indices,
crypto,
forex
示例:

"stock"

响应

200 - application/json

Successful response

​
code
integer
示例:

0

​
message
string
示例:

"success"

​
data
object