取得K線數據

GET

https://api-futures.kucoin.com/api/v1/kline/query

api-channel:Public

api-permission:NULL

api-rate-limit-pool:Public

api-rate-limit-weight:3

sdk-service:Futures

sdk-method-name:getKlines

sdk-sub-service:Market

說明

獲取交易對的K線圖表數據。數據根據請求的類型以分組時間段返回。

每次查詢，系統最多返回500筆數據。如需獲取更多數據，請按時間分頁查詢。

提示

K線圖表數據可能不完整，無交易tick的時間段不會發布數據。

若指定的開始/結束時間及時間粒度超出單次請求的最大限制，系統僅返回500筆數據。如需獲取更大時間範圍的細粒度數據，需指定時間範圍並進行多次請求。

若請求僅指定開始時間，系統將返回從開始時間到當前系統時間的500筆數據；
若僅指定結束時間，系統將返回最接近結束時間的500筆數據；
若未指定開始時間和結束時間，系統將返回最接近當前系統時間的500筆數據。

Request

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api-futures.kucoin.com/api/v1/kline/query?symbol=XBTUSDTM&granularity=1&from=1757659047000&to=1757659647000'

Responses

🟢200確認

application/json

Body

Example

{
    "code": "200000",
    "data": [
        [
            1757659080000,
            115328.4,
            115328.4,
            115284.2,
            115284.2,
            602,
            69424.9528
        ],
        [
            1757659140000,
            115273.0,
            115273.1,
            115273.0,
            115273.0,
            114,
            13141.1236
        ]
    ]
}

Modified at 2026-02-25 12:41:02

取得交易歷史

獲取標記價格