跳到主要内容

获取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"

请求参数

参数名参数类型是否必须描述
symbolString交易币对
productTypeString产品类型
USDT-FUTURES USDT专业合约
COIN-FUTURES 混合合约
USDC-FUTURES USDC专业合约
SUSDT-FUTURES USDT专业合约模拟盘
SCOIN-FUTURES 混合合约模拟盘
SUSDC-FUTURES USDC专业合约模拟盘
granularityStringk线粒度
- 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 (零时区 月线)
startTimeString开始时间 即查询该时间之后的k线
需根据时间粒度不同,将对应时间单位向下取整来查询。
Unix时间戳的毫秒数格式,如 1672410780000
请求在此开始时间之后的数据(最大时间查询范围为90天)
endTimeString结束时间 即查询该时间之前的k线
需根据时间粒度不同,将对应时间单位向下取整来查询。
Unix时间戳的毫秒数格式,如 1672410780000
请求在此结束时间之前的数据(最大时间查询范围为90天)
kLineTypeStringk线类型:MARKET 行情;MARK 标记;INDEX 指数;
默认 MARKET
limitString默认 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计价币成交量