跳转到主要内容
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": [
    {
      "timestamp": 1703123456789,
      "open": "43000.00",
      "high": "43250.50",
      "low": "42800.00",
      "close": "43100.00",
      "volume": "1250.5"
    }
  ]
}
GET /v1/market/kline

​
📌 接口说明

本接口返回已结束时间周期的历史 K 线数据。
  • 数据已固定，不会再发生变化
  • 适用于回测与历史分析
  • 若需获取当前周期内正在更新的 K 线，请使用 👉实时K线： /v1/market/kline/latest

​
🧠 生命周期说明

周期开始 → 实时更新 → 周期结束 → 进入历史数据 历史 K 线表示“周期已结束”的稳定数据。

​
🎯 适用场景

  • 策略回测
  • 技术指标计算
  • 数据归档存储

​
🔍 与实时 K 线的区别

项目历史 K 线实时 K 线
时间范围已结束周期当前周期
数据状态固定不变会持续变化
适用场景分析 / 回测实时行情
是否更新不会会

​
多市场示例

加密货币：BTCUSDT、ETHUSDT、ADAUSDT
美股：AAPL.US、TSLA.US、MSFT.US
港股：700.HK、9988.HK、3690.HK
外汇：EURUSD、GBPUSD、USDJPY
贵金属：XAUUSD、XAGUSD

​
支持的时间间隔

  • 分钟：1m、5m、15m、30m
  • 小时：1h、4h、12h
  • 天：1d、1w、1M

​
请求示例

curl -H "X-API-Key: YOUR_API_KEY" \
     "https://api.tickdb.ai/v1/market/kline?symbol=AAPL.US&interval=1m&limit=5"

​
响应示例

{
    "code": 0,
    "message": "success",
    "data": {
        "symbol": "AAPL.US",
        "interval": "1m",
        "klines": [
            {
                "time": 1768251300000,
                "open": "260.29",
                "high": "260.41",
                "low": "260.09",
                "close": "260.09",
                "volume": "129288",
                "quote_volume": "33640306.64"
            },
            {
                "time": 1768251360000,
                "open": "260.08",
                "high": "260.17",
                "low": "260.01",
                "close": "260.15",
                "volume": "124012",
                "quote_volume": "32256761.32"
            },
            {
                "time": 1768251420000,
                "open": "260.15",
                "high": "260.31",
                "low": "260.072",
                "close": "260.23",
                "volume": "111445",
                "quote_volume": "28998434.78"
            },
            {
                "time": 1768251480000,
                "open": "260.23",
                "high": "260.32",
                "low": "260.16",
                "close": "260.23",
                "volume": "127622",
                "quote_volume": "33211923.87"
            },
            {
                "time": 1768251540000,
                "open": "260.22",
                "high": "260.35",
                "low": "260.19",
                "close": "260.25",
                "volume": "285977",
                "quote_volume": "74429327.28"
            }
        ]
    }
}

授权

​
X-API-Key
string
header
必填

查询参数

​
symbol
string
必填

Trading symbol

示例:

"BTCUSDT"

​
interval
enum<string>
必填

K-line interval

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

"1h"

​
limit
integer
默认值:100

Number of records (default 100, max 1000)

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

24

​
start_time
integer

Start timestamp in milliseconds

示例:

1703123456789

​
end_time
integer

End timestamp in milliseconds

示例:

1703209856789

响应

200 - application/json

Successful response

​
code
integer
示例:

0

​
message
string
示例:

"success"

​
data
object[]