跳到主要内容

获取K线数据

限速规则 20次/1s (IP)

描述

获取K线数据

HTTP请求

  • GET /api/v2/spot/market/candles
请求示例
curl "https://api.bitget.com/api/v2/spot/market/candles?symbol=BTCUSDT&granularity=1min&startTime=1659076670000&endTime=1659080270000&limit=100"

请求参数

参数名参数类型是否必须描述
symbolString交易对名称,如BTCUSDT
granularityStringK线的时间颗粒度
分钟:1min,5min,15min,30min
小时:1h,4h,6h,12h
天:1day,3day
周:1week
月:1M
零时区小时线:6Hutc,12Hutc
零时区日线:1Dutc ,3Dutc
零时区周线:1Wutc
零时区月线:1Mutc
1m、3m、5m可以查一个月 ;15m可以查52天; 30m查62天; 1H可以查83天; 2H可以查120天; 4H可以查240天; 6H可以查360天
startTimeStringK线数据的时间起始点,即获取该时间戳以后的K线数据
Unix毫秒时间戳,例如1690196141868
endTimeStringK线数据的时间终止点,即获取该时间戳以前的K线数据
Unix毫秒时间戳,例如1690196141868
limitString查询条数
默认100,最大1000
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1695800278693,
"data": [
[
"1656604800000",
"37834.5",
"37849.5",
"37773.5",
"37773.5",
"428.3462",
"16198849.1079",
"16198849.1079"
],
[
"1656604800000",
"37834.5",
"37849.5",
"37773.5",
"37773.5",
"428.3462",
"16198849.1079",
"16198849.1079"
]
]
}

返回参数

返回字段参数类型字段说明
index[0]String系统时间戳,Unix毫秒时间戳,例如1690196141868
index[1]String开盘价格
index[2]String最高价格
index[3]String最低价格
index[4]String收盘价格
index[5]String基础币成交量,如BTCUSDT交易对中的BTC
index[6]StringUSDT成交量
index[7]String计价币成交量,如BTCUSDT交易对中的USDT