获取 K 线
获取指定交易对的指定时间范围内的 k 线数据。 (鉴权类型:NONE, 参见接口权限)
请求格式
GET https://api-cloud.bitmart.com/spot/v1/symbols/kline
请求限制
参见 速率限制详细
请求参数
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | string | 必填 | 交易对 symbol |
| from | long | 必填 | 开始时间 (UTC+0, 精确到秒) |
| to | long | 必填 | 结束时间 (UTC+0, 精确到秒) |
| step | long | 可选(默认 1 分钟) | k 线步长Steps (用分钟表示, 默认 1 分钟) |
请求示例
curl https://api-cloud.bitmart.com/spot/v1/symbols/kline?symbol=BMX_ETH&step=15&from=1525760116&to=1525769116
响应详情
| 字段 | 类型 | 描述 |
|---|---|---|
| kline | List | k 线列表 |
解释说明
请求KLine数据限制最多500条，大于500条会返回空数组
k线详情字段描述：
| 字段 | 类型 | 描述 |
|---|---|---|
| last_price | string | 当前价格 |
| timestamp | long | 时间戳 (UTC+0, 精确到秒) |
| volume | string | 交易总量 |
| open | string | 开盘价 |
| high | string | 最高价 |
| low | string | 最低价 |
| close | string | 收盘价 |
返回数据格式示例
{
"message":"OK",
"code":1000,
"trace":"ae7ede4c-04a3-4004-bd8b-022a12d17e45",
"data":{
"klines":[
{
"timestamp":1590969600,
"open":"1.2400000000",
"high":"1.2400000000",
"low":"1.2000000000",
"close":"1.2000000000",
"last_price":"1.2000000000",
"volume":"4.9000000000"
}
]
}
}