Skip to main content

MarketDataStream — bidirectional стрим предоставления биржевой информации

/tinkoff.public.invest.api.contract.v1.MarketDataStreamService/MarketDataStream

POST

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

MarketDataStream — bidirectional стрим предоставления биржевой информации

Авторизация

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

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

APIСценарииПодключение
Все сервисы T-API

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