Перейти к основному содержимому

Свечи

Данные свечей в реальном времени.

Внимание

Массив свечей использует порядок [start, open, close, high, low, baseVolume]. Это отличается от стандартного формата OHLCV, где High и Low идут перед Close.

Запрос на подписку:

{
  "id": "12345",
  "method": "subscribe",
  "params": {
    "channel": "candles",
    "symbol": "BTC-USDT",
    "type": "1hour",
    "snapshot": {
      "startAt": "2024-12-23T00:00:00.000Z",
      "endAt": "2024-12-23T23:59:59.999Z"
    }
  }
}

Параметры запроса​

ПараметрОписание
symbol (обязательный)Символ торговой пары. Укажите торговую пару, чтобы получать обновления. См. все доступные на данный момент торговые пары в статье Get /api/v1/symbols.
type (обязательный)Интервал свечи. Укажите интервал времени для получения обновлений. Доступные значения: 1min, 5min, 15min, 30min, 1hour, 2hour, 4hour, 8hour, 12hour, 1day, 1week, 1month.
snapshot (необязательный)Диапазон исторических данных задается следующими значениями startAt и endAt. Установите этот диапазон, чтобы получить данные свечей за указанный период в первоначальном ответе. Если этот диапазон не задан в запросе, то свечи не возвращаются в начальном ответе, однако в потоковых данных свечи все равно возвращаются.
startAt (обязательный)Дата и время начала.
endAt (обязательный)Дата и время окончания.

Ответ​

Ответ на подписку:

{
  "id": "12345",
  "result": {
    "success": true,
    "candles": [
      [
        "2024-12-23T10:00:00.000Z",
        "50800.00",
        "51000.00",
        "51100.00",
        "50700.00",
        "98.45678"
      ],
      [
        "2024-12-23T11:00:00.000Z",
        "51000.00",
        "51200.00",
        "51250.00",
        "50950.00",
        "125.67890"
      ]
    ]
  }
}

Пример потока данных:

{
  "method": "subscription",
  "params": {
    "channel": "candles",
    "symbol": "BTC-USDT",
    "type": "1hour",
    "data": {
      "candle": [
        "2024-12-23T12:00:00.000Z",
        "51000.00",
        "51200.00",
        "51250.00",
        "50950.00",
        "125.67890"
      ]
    }
  }
}

Параметры ответа​

Поле candle представляет собой позиционный массив: [start, open, close, high, low, baseVolume]. Примечание: Этот порядок отличается от стандартного формата OHLCV, где High и Low идут перед Close.

ПараметрОписание
start (обязательный)Время начала свечи. Тип: string.
open (обязательный)Цена открытия за указанный период. Тип: string.
close (обязательный)Цена закрытия за указанный период. Тип: string.
high (обязательный)Максимальная цена актива за указанный период. Тип: string.
low (обязательный)Минимальная цена актива за указанный период. Тип: string.
baseVolume (обязательный)Общий объём базовой валюты, проторгованный за указанный период. Тип: string.