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