Запросить исторические свечи по инструменту.

POST

https://invest-public-api.tinkoff.ru/rest//tinkoff.public.invest.api.contract.v1.MarketDataService/GetCandles

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

from

String<date-time>

Начало запрашиваемого периода по UTC.

Required

String<date-time>

Окончание запрашиваемого периода по UTC.

Required

interval

String (v1CandleInterval)

Requirements: [CANDLE_INTERVAL_UNSPECIFIED, CANDLE_INTERVAL_1_MIN, CANDLE_INTERVAL_5_MIN, CANDLE_INTERVAL_15_MIN, CANDLE_INTERVAL_HOUR, CANDLE_INTERVAL_DAY, CANDLE_INTERVAL_2_MIN, CANDLE_INTERVAL_3_MIN, CANDLE_INTERVAL_10_MIN, CANDLE_INTERVAL_30_MIN, CANDLE_INTERVAL_2_HOUR, CANDLE_INTERVAL_4_HOUR, CANDLE_INTERVAL_WEEK, CANDLE_INTERVAL_MONTH]

Default: CANDLE_INTERVAL_UNSPECIFIED

Интервал свечей. Максимальное значение интервала приведено ориентировочно, может отличаться в большую сторону в зависимости от параметров запроса.

CANDLE_INTERVAL_UNSPECIFIED: Интервал не определен.
CANDLE_INTERVAL_1_MIN: От 1 минуты до 1 дня. Максимальное значение limit — 2400.
CANDLE_INTERVAL_5_MIN: От 5 минут до недели. Максимальное значение limit — 2400.
CANDLE_INTERVAL_15_MIN: От 15 минут до 3 недель. Максимальное значение limit — 2400.
CANDLE_INTERVAL_HOUR: От 1 часа до 3 месяцев. Максимальное значение limit — 2400.
CANDLE_INTERVAL_DAY: От 1 дня до 6 лет. Максимальное значение limit — 2400.
CANDLE_INTERVAL_2_MIN: От 2 минут до 1 дня. Максимальное значение limit — 1200.
CANDLE_INTERVAL_3_MIN: От 3 минут до 1 дня. Максимальное значение limit — 750.
CANDLE_INTERVAL_10_MIN: От 10 минут до недели. Максимальное значение limit — 1200.
CANDLE_INTERVAL_30_MIN: От 30 минут до 3 недель. Максимальное значение limit — 1200.
CANDLE_INTERVAL_2_HOUR: От 2 часов до 3 месяцев. Максимальное значение limit — 2400.
CANDLE_INTERVAL_4_HOUR: От 4 часов до 3 месяцев. Максимальное значение limit — 700.
CANDLE_INTERVAL_WEEK: От 1 недели до 5 лет. Максимальное значение limit — 300.
CANDLE_INTERVAL_MONTH: От 1 месяца до 10 лет. Максимальное значение limit — 120.

instrumentId

String

Идентификатор инструмента. Принимает значение figi или instrument_uid.

candleSourceType

String (v1GetCandlesRequestCandleSource)

Requirements: [CANDLE_SOURCE_UNSPECIFIED, CANDLE_SOURCE_EXCHANGE, CANDLE_SOURCE_INCLUDE_WEEKEND]

Default: CANDLE_SOURCE_UNSPECIFIED

CANDLE_SOURCE_UNSPECIFIED: Все свечи.
CANDLE_SOURCE_EXCHANGE: Биржевые свечи.
CANDLE_SOURCE_INCLUDE_WEEKEND: Все свечи с учетом торговли по выходным.

limit

Integer<int32>

Максимальное количество свечей в ответе.

Ответ

200

A successful response.

400

Запрос составлен неверно, проверьте параметры вызова и синтаксические ошибки.

401

Токен доступа не найден или не активен.

403

Недостаточно прав для выполнения запроса, проверьте соответствие токена и передаваемого в запросе счета.

404

Неверный URL запроса или переданный параметр не определен.

408

Время передачи запроса клиентом истекло. Проверьте работу приложения.

415

Неверный тип данных, проверьте формат передаваемого сообщения.

429

Превышен лимит запросов в минуту.

500

Внутренняя ошибка сервера, попробуйте повторить запрос позже

501

Метод не реализован, проверьте путь вызова в запросе.

503

Сервис временно недоступен, попробуйте повторить запрос позже.

504

Превышен интервал ожидания ответа от сервера, попробуйте повторить запрос позже.

default

An unexpected error response.

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции