获取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	计价币成交量