跳轉到主要內容
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[]