Skip to main content

GetCandles — исторические свечи по инструменту

/tinkoff.public.invest.api.contract.v1.MarketDataService/GetCandles

POST

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

GetCandles — исторические свечи по инструменту

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

Required

from

String<date-time>

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

Required

to

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, CANDLE_INTERVAL_5_SEC, CANDLE_INTERVAL_10_SEC, CANDLE_INTERVAL_30_SEC]

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.
  • CANDLE_INTERVAL_5_SEC: От 5 секунд до 200 минут. Максимальное значение limit — 2500.
  • CANDLE_INTERVAL_10_SEC: От 10 секунд до 200 минут. Максимальное значение limit — 1250.
  • CANDLE_INTERVAL_30_SEC: От 30 секунд до 20 часов. Максимальное значение limit — 2500.

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

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

408

Request Timeout

415

Unsupported Media Type

429

Too Many Requests

500

Internal Server Error

501

Not Implemented

503

Service Unavailable

504

Gateway Timeout

default

An unexpected error response

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

Loading...

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie» с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.