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