跳轉到主要內容
GET
/
v1
/
market
/
kline
/
latest
Latest K-line Data
curl --request GET \
  --url https://api.tickdb.ai/v1/market/kline/latest \
  --header 'X-API-Key: <api-key>'
{
  "code": 0,
  "message": "success",
  "data": [
    {
      "symbol": "AAPL.US",
      "interval": "3m",
      "klines": [
        {
          "time": 1773259020000,
          "open": "260.86",
          "high": "261.05",
          "low": "260.7",
          "close": "260.81",
          "volume": "963419",
          "quote_volume": "251311057.55"
        }
      ]
    },
    {
      "symbol": "00700.HK",
      "interval": "3m",
      "klines": [
        {
          "time": 1773293400000,
          "open": "542.5",
          "high": "544.5",
          "low": "542",
          "close": "544.5",
          "volume": "80300",
          "quote_volume": "43656433.33"
        }
      ]
    }
  ]
}

​
注意事項

  • 本接口返回當前週期內正在形成的K線數據，數據會隨著成交持續更新
  • 適用於實時行情圖表展示、當前價格監控、分時動態更新
  • 不建議用於歷史回測、技術指標統計、固定數據存儲
  • 若需查詢已結束週期的數據，請使用歷史K線：/v1/market/kline

​
支持的市場

外匯、貴金屬、指數、美股、港股、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

​
請求參數

參數名是否必須描述
symbols是交易產品代碼，多個用逗號分隔，例如：AAPL.US,00700.HK
interval是K線週期，可選值：1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 1d, 1w, 1M
type否產品類型，可選。代碼無歧義時無需傳遞；若返回 AMBIGUOUS_SYMBOL 錯誤，按提示傳入對應值即可。可選值：stock、indices、crypto、forex

​
返回字段說明

字段說明
symbol交易產品
intervalK線週期
klinesK線數據數組
└─ timeK線時間戳（毫秒）
└─ open開盤價
└─ high最高價
└─ low最低價
└─ close收盤價
└─ volume成交量
└─ quote_volume成交額

授權

​
X-API-Key
string
header
必填

查詢參數

​
symbols
string
預設值:AAPL.US,00700.HK
必填

Comma-separated symbols (e.g., AAPL.US,00700.HK)

範例:

"AAPL.US,00700.HK"

​
interval
enum<string>
預設值:3m
必填

K-line interval

可用選項:
1m,
3m,
5m,
15m,
30m,
1h,
2h,
4h,
1d,
1w,
1M
範例:

"3m"

​
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"

回應

Successful response

​
code
integer
範例:

0

​
message
string
範例:

"success"

​
data
object[]
範例:
[
  {
    "symbol": "AAPL.US",
    "interval": "3m",
    "klines": [
      {
        "time": 1773259020000,
        "open": "260.86",
        "high": "261.05",
        "low": "260.7",
        "close": "260.81",
        "volume": "963419",
        "quote_volume": "251311057.55"
      }
    ]
  },
  {
    "symbol": "00700.HK",
    "interval": "3m",
    "klines": [
      {
        "time": 1773293400000,
        "open": "542.5",
        "high": "544.5",
        "low": "542",
        "close": "544.5",
        "volume": "80300",
        "quote_volume": "43656433.33"
      }
    ]
  }
]