Bidirectional-стрим предоставления биржевой информации.

POST

https://invest-public-api.tinkoff.ru/rest//tinkoff.public.invest.api.contract.v1.MarketDataStreamService/MarketDataStream

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

subscribeCandlesRequest

Object (v1SubscribeCandlesRequest)

subscribeCandles | Изменения статуса подписки на свечи.

subscriptionAction

String (v1SubscriptionAction)

Requirements: [SUBSCRIPTION_ACTION_UNSPECIFIED, SUBSCRIPTION_ACTION_SUBSCRIBE, SUBSCRIPTION_ACTION_UNSUBSCRIBE]

Default: SUBSCRIPTION_ACTION_UNSPECIFIED

Тип операции со списком подписок.

SUBSCRIPTION_ACTION_UNSPECIFIED: Статус подписки не определен.
SUBSCRIPTION_ACTION_SUBSCRIBE: Подписаться.
SUBSCRIPTION_ACTION_UNSUBSCRIBE: Отписаться.

instruments

Array of objects ()

Массив инструментов для подписки на свечи.

figi

String

Deprecated FIGI-идентификатор инструмента. Используйте instrument_id.

interval

String (v1SubscriptionInterval)

Requirements: [SUBSCRIPTION_INTERVAL_UNSPECIFIED, SUBSCRIPTION_INTERVAL_ONE_MINUTE, SUBSCRIPTION_INTERVAL_FIVE_MINUTES, SUBSCRIPTION_INTERVAL_FIFTEEN_MINUTES, SUBSCRIPTION_INTERVAL_ONE_HOUR, SUBSCRIPTION_INTERVAL_ONE_DAY, SUBSCRIPTION_INTERVAL_2_MIN, SUBSCRIPTION_INTERVAL_3_MIN, SUBSCRIPTION_INTERVAL_10_MIN, SUBSCRIPTION_INTERVAL_30_MIN, SUBSCRIPTION_INTERVAL_2_HOUR, SUBSCRIPTION_INTERVAL_4_HOUR, SUBSCRIPTION_INTERVAL_WEEK, SUBSCRIPTION_INTERVAL_MONTH]

Default: SUBSCRIPTION_INTERVAL_UNSPECIFIED

Интервал свечи.

SUBSCRIPTION_INTERVAL_UNSPECIFIED: Интервал свечи не определен.
SUBSCRIPTION_INTERVAL_ONE_MINUTE: Минутные свечи.
SUBSCRIPTION_INTERVAL_FIVE_MINUTES: Пятиминутные свечи.
SUBSCRIPTION_INTERVAL_FIFTEEN_MINUTES: Пятнадцатиминутные свечи.
SUBSCRIPTION_INTERVAL_ONE_HOUR: Часовые свечи.
SUBSCRIPTION_INTERVAL_ONE_DAY: Дневные свечи.
SUBSCRIPTION_INTERVAL_2_MIN: Двухминутные свечи.
SUBSCRIPTION_INTERVAL_3_MIN: Трехминутные свечи.
SUBSCRIPTION_INTERVAL_10_MIN: Десятиминутные свечи.
SUBSCRIPTION_INTERVAL_30_MIN: Тридцатиминутные свечи.
SUBSCRIPTION_INTERVAL_2_HOUR: Двухчасовые свечи.
SUBSCRIPTION_INTERVAL_4_HOUR: Четырехчасовые свечи.
SUBSCRIPTION_INTERVAL_WEEK: Недельные свечи.
SUBSCRIPTION_INTERVAL_MONTH: Месячные свечи.

instrumentId

String

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

waitingClose

Boolean

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

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: Все свечи с учетом торговли по выходным.

subscribeOrderBookRequest

Object (v1SubscribeOrderBookRequest)

Запрос на изменение статуса подписки на стаканы.

subscriptionAction

String (v1SubscriptionAction)

Requirements: [SUBSCRIPTION_ACTION_UNSPECIFIED, SUBSCRIPTION_ACTION_SUBSCRIBE, SUBSCRIPTION_ACTION_UNSUBSCRIBE]

Default: SUBSCRIPTION_ACTION_UNSPECIFIED

Тип операции со списком подписок.

SUBSCRIPTION_ACTION_UNSPECIFIED: Статус подписки не определен.
SUBSCRIPTION_ACTION_SUBSCRIBE: Подписаться.
SUBSCRIPTION_ACTION_UNSUBSCRIBE: Отписаться.

instruments

Array of objects ()

Массив инструментов для подписки на стаканы.

figi

String

Deprecated FIGI-идентификатор инструмента. Используйте instrument_id.

depth

Integer<int32>

Глубина стакана.

instrumentId

String

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

orderBookType

String (v1OrderBookType)

Requirements: [ORDERBOOK_TYPE_UNSPECIFIED, ORDERBOOK_TYPE_EXCHANGE, ORDERBOOK_TYPE_DEALER, ORDERBOOK_TYPE_ALL]

Default: ORDERBOOK_TYPE_UNSPECIFIED

ORDERBOOK_TYPE_UNSPECIFIED: Не определен.
ORDERBOOK_TYPE_EXCHANGE: Биржевой стакан.
ORDERBOOK_TYPE_DEALER: Стакан дилера.
ORDERBOOK_TYPE_ALL: Стакан биржевой и дилера.

subscribeTradesRequest

Object (v1SubscribeTradesRequest)

Изменение статуса подписки на поток обезличенных сделок.

subscriptionAction

String (v1SubscriptionAction)

Requirements: [SUBSCRIPTION_ACTION_UNSPECIFIED, SUBSCRIPTION_ACTION_SUBSCRIBE, SUBSCRIPTION_ACTION_UNSUBSCRIBE]

Default: SUBSCRIPTION_ACTION_UNSPECIFIED

Тип операции со списком подписок.

SUBSCRIPTION_ACTION_UNSPECIFIED: Статус подписки не определен.
SUBSCRIPTION_ACTION_SUBSCRIBE: Подписаться.
SUBSCRIPTION_ACTION_UNSUBSCRIBE: Отписаться.

instruments

Array of objects ()

Массив инструментов для подписки на поток обезличенных сделок.

figi

String

Deprecated FIGI-идентификатор инструмента. Используйте instrument_id`.

instrumentId

String

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

tradeSource

String (v1TradeSourceType)

Requirements: [TRADE_SOURCE_UNSPECIFIED, TRADE_SOURCE_EXCHANGE, TRADE_SOURCE_DEALER, TRADE_SOURCE_ALL]

Default: TRADE_SOURCE_UNSPECIFIED

Типы источников сделок.

TRADE_SOURCE_UNSPECIFIED: Тип источника сделки не определён.
TRADE_SOURCE_EXCHANGE: Биржевые сделки.
TRADE_SOURCE_DEALER: Сделки дилера.
TRADE_SOURCE_ALL: Все сделки.

subscribeInfoRequest

Object (v1SubscribeInfoRequest)

Изменение статуса подписки на торговый статус инструмента.

subscriptionAction

String (v1SubscriptionAction)

Requirements: [SUBSCRIPTION_ACTION_UNSPECIFIED, SUBSCRIPTION_ACTION_SUBSCRIBE, SUBSCRIPTION_ACTION_UNSUBSCRIBE]

Default: SUBSCRIPTION_ACTION_UNSPECIFIED

Тип операции со списком подписок.

SUBSCRIPTION_ACTION_UNSPECIFIED: Статус подписки не определен.
SUBSCRIPTION_ACTION_SUBSCRIBE: Подписаться.
SUBSCRIPTION_ACTION_UNSUBSCRIBE: Отписаться.

instruments

Array of objects ()

Массив инструментов для подписки на торговый статус.

figi

String

Deprecated FIGI-идентификатор инструмента. Используйте instrument_id`.

instrumentId

String

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

subscribeLastPriceRequest

Object (v1SubscribeLastPriceRequest)

Изменение статуса подписки на цену последней сделки по инструменту.

subscriptionAction

String (v1SubscriptionAction)

Requirements: [SUBSCRIPTION_ACTION_UNSPECIFIED, SUBSCRIPTION_ACTION_SUBSCRIBE, SUBSCRIPTION_ACTION_UNSUBSCRIBE]

Default: SUBSCRIPTION_ACTION_UNSPECIFIED

Тип операции со списком подписок.

SUBSCRIPTION_ACTION_UNSPECIFIED: Статус подписки не определен.
SUBSCRIPTION_ACTION_SUBSCRIBE: Подписаться.
SUBSCRIPTION_ACTION_UNSUBSCRIBE: Отписаться.

instruments

Array of objects ()

Массив инструментов для подписки на цену последней сделки.

figi

String

Deprecated FIGI-идентификатор инструмента. Используйте instrument_id`.

instrumentId

String

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

getMySubscriptions

Object

Запрос активных подписок. Возвращает по одному сообщению на каждый тип активных подписок — SubscribeLastPriceResponse, SubscribeInfoResponse, SubscribeTradesResponse, SubscribeOrderBookResponse, SubscribeCandlesResponse.

ping

Object (v1PingRequest)

time

String<date-time>

Время формирования запроса.

pingSettings

Object (v1PingDelaySettings)

pingDelayMs

Integer<int32>

Задержка (пинг) сообщений: 5000–180 000 миллисекунд. Значение по умолчанию — 120 000.

Ответ

200

A successful response.(streaming responses)

400

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

401

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

403

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

404

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

408

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

415

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

429

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

500

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

501

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

503

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

504

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

default

An unexpected error response.

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

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

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