获取K线数据
限速规则: 20次/1s (IP)
描述
默认返回100条记录。若无数据则返回为空数组。可查询的数据历史,依据k线粒度而不同。
规则如下:
1m、3m、5m可查最久一个月 ;
15m可查最久52天;
30m可查最久62天;
1H可查最久83天;
2H可查最久120天;
4H可查最久240天;
6H可查最久360天
HTTP请求
- GET /api/v2/mix/market/candles
请求示例
curl "https://api.bitget.com/api/v2/mix/market/candles?symbol=BTCUSDT&granularity=5m&limit=100&productType=usdt-futures"
请求参数
参数名 | 参数类型 | 是否必须 | 描述 |
---|---|---|---|
symbol | String | 是 | 交易币对 |
productType | String | 是 | 产品类型USDT-FUTURES USDT专业合约COIN-FUTURES 混合合约USDC-FUTURES USDC专业合约SUSDT-FUTURES USDT专业合约模拟盘SCOIN-FUTURES 混合合约模拟盘SUSDC-FUTURES USDC专业合约模拟盘 |
granularity | String | 是 | k线粒度 - 1m(1分钟) - 3m(3分钟) - 5m(5分钟) - 15m(15分钟) - 30m(30分钟) - 1H(1小时) - 4H(4小时) - 6H(6小时) - 12H(12小时) - 1D(1天) - 3D (3天) - 1W(1周) - 1M (月线) - 6Hutc (零时区 6小时线) - 12Hutc (零时区12小时线) - 1Dutc (零时区 1日线) - 3Dutc (零时区 3日线) - 1Wutc (零时区 周线) - 1Mutc (零时区 月线) |
startTime | String | 否 | 开始时间 即查询该时间之后的k线 需根据时间粒度不同,将对应时间单位向下取整来查询。 Unix时间戳的毫秒数格式,如 1672410780000 请求在此开始时间之后的数据(最大时间查询范围为90天) |
endTime | String | 否 | 结束时间 即查询该时间之前的k线 需根据时间粒度不同,将对应时间单位向下取整来查询。 Unix时间戳的毫秒数格式,如 1672410780000 请求在此结束时间之前的数据(最大时间查询范围为90天) |
kLineType | String | 否 | k线类型:MARKET 行情;MARK 标记;INDEX 指数; 默认 MARKET |
limit | String | 否 | 默认 100, 最大 1000 |
返回示例
{
"code": "00000",
"msg": "success",
"requestTime": 1695865615662,
"data": [
[
"1695835800000",
"26210.5",
"26210.5",
"26194.5",
"26194.5",
"26.26",
"687897.63"
],
[
"1695836100000",
"26194.5",
"26194.5",
"26171",
"26171",
"17.98",
"470618.72"
]
]
}
返回参数
返回字段 | 参数类型 | 字段说明 |
---|---|---|
index[0] | String | 时间戳, Unix时间戳的毫秒数格式,如 1597026383085 |
index[1] | String | 开盘价 |
index[2] | String | 最高价 |
index[3] | String | 最低价 |
index[4] | String | 收盘价, 最新一个收盘价可能还在持续更新,请订阅websocket跟踪最新价 |
index[5] | String | 交易币成交量 |
index[6] | String | 计价币成交量 |