Исторические свечи
GET/api/v1/candles-chart
Метод предназначен для получения исторических данных по инструменту.
Ограничение
Максимальное количество баров в одном запросе — 1440
Если запрошенный временной интервал с учётом параметра timeFrame содержит более 1440 свечей, сервер вернёт ошибку.
Зачем это ограничение
Ограничение введено для обеспечения стабильной работы сервиса и предсказуемого времени ответа.
Как избежать ошибки
- Уменьшите временной интервал (
startDate/endDate) - Используйте более крупный
timeFrame(например,H1вместоM5) - Разбивайте большой период на несколько последовательных запросов
Пример
Если вы запрашиваете свечи с таймфреймом M1, максимальный допустимый период — 1440 минут.
Запрос большего интервала приведёт к ошибке.
Последний бар может быть не закрыт
Метод возвращает свечи за запрошенный период на момент запроса. Если endDate попадает в текущий, ещё не завершённый интервал timeFrame, последний бар в массиве bars — это формирующаяся свеча, а не историческая. Она отражает сделки только за прошедшую часть интервала и будет меняться при повторных запросах, пока интервал не завершится.
Пример
Запрос свечей H1 в 12:00:03 в период торгов. Свеча 11:00–12:00 уже закрыта. Интервал 12:00–13:00 вернётся как открытая свеча, построенная по сделкам за первые секунды (12:00:00–12:00:03), и не совпадёт с итоговой свечой за этот час.
Как получить закрытую свечу
- Запрашивайте период с
endDate, не позже начала текущего незавершённого интервала (дляH1— не позже начала текущего часа). - Либо проверяйте последний бар: если время его начала плюс длительность
timeFrameбольше текущего времени, считайте свечу неокончательной и не используйте её как историческую. - Повторный запрос после завершения интервала вернёт свечу в итоговом виде.
Request
Responses
- 200
- 400
- 429
OK