K线資料

接口描述

取得K线資料，可查询指定代幣（仅支持USDT交易对）和指定时间段内不超过1000条的K线資料。

使用场景：

• 适用于查询不同时间窗口類型的K线資料查询
• 适用于结合价格K线判断買賣时机

資料更新频率：根据 bucketType 实时更新

請求URL

• 方法：POST
• 路径：/open/v1/trade/kline/getTradeKLineList

积分消耗

• 消耗积分：1

前置条件

取得 vsTokenId

条件	说明	取得方式
已有 vsTokenId	直接使用缓存的 vsTokenId，无需重复查询	上下文自动提取
未有 vsTokenId	调用 POST /vs-token/list 接口取得	前置接口调用

請求参数

参数通过請求體（Body）以 JSON 格式传递。

参数名	類型	必需	描述
vsTokenId	long	是	代幣 ID
bucketType	string	是	K线时间窗口類型
startTime	long	否	开始时间（毫秒时间戳）
endTime	long	是	结束时间（毫秒时间戳）
size	integer	否	查询记錄数，預設360条，最大不超过1000条

枚举值说明

bucketType - K线时间窗口類型

值	含义
5m	5 分鐘
15m	15 分鐘
30m	30 分鐘
1h	1 小时
4h	4 小时
1d	1 天
1w	1 周

回應欄位

仅展示 data 对象内的欄位结构：

欄位	類型	实际返回類型	描述
vsTokenId	long	string	代幣 ID
symbol	string	string	代幣符号
name	string	string	代幣名称
klineType	string	string	K线類型
klineData	array	array	K线資料
time	long	long	时间（毫秒时间戳）
open	number	string	开盤价
close	number	string	收盤价
high	number	string	最高价
low	number	string	最低价
volume	number	string	成交量
amount	number	string	成交额(USD)

欄位业务含义

欄位	业务含义	使用建议
volume	成交量	反映该时间周期的交易活跃程度
amount	成交额	以USD計价的交易金额，结合volume可計算成交均价

請求示例

{
    "vsTokenId": 1,               // 代幣 id
    "bucketType": "5m",            // K线时间窗口類型
    "endTime": 1773478632535,      // 结束时间
    "size": 20                     // 查询记錄数，預設360条，最大不超过1000条
}

cURL 示例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/trade/kline/getTradeKLineList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "bucketType": "5m",
    "endTime": 1773478632535,
    "size": 20
}'

cURL 示例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/trade/kline/getTradeKLineList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"bucketType\": \"5m\",    \"endTime\": 1773478632535,    \"size\": 20}"

成功回應示例

{
    "code": 200,
    "message": "success",
    "data": {
        "vsTokenId": "1",                       // 代幣 ID
        "symbol": "BTC",                         // 代幣符号
        "name": "Bitcoin",                       // 代幣名称
        "klineType": "01",                       // K线類型
        "klineData": [
            {
                "time": 1773478200000,            // 时间
                "open": "70544.92",                // 开盤价
                "close": "70594.48",               // 收盤价
                "high": "70594.49",                // 最高价
                "low": "70536.58",                 // 最低价
                "volume": "20.543779999999995",    // 成交量
                "amount": "1449509.9399093997"     // 成交额(USD)
            },
            {
                "time": 1773477900000,
                "open": "70562.01",
                "close": "70544.92",
                "high": "70586.21",
                "low": "70536.72",
                "volume": "57.95012",
                "amount": "4089095.6473876997"
            },
            {
                "time": 1773477600000,
                "open": "70612.38",
                "close": "70562",
                "high": "70613.76",
                "low": "70562",
                "volume": "14.238029999999998",
                "amount": "1004960.1104217"
            }
            // ... 更多資料省略
        ]
    },
    "requestId": "xxx-xxx-xxx"
}