Перейти к основному содержимому

gRPC-методы

С помощью методов сервиса можно получить:

  • информацию об инструментах;
  • расписания торговых сессий;
  • календарь выплат купонов по облигациям;
  • размер гарантийного обеспечения по фьючерсам;
  • дивиденды по ценной бумаге.

Протестировать и отправить запросы можно через REST-методы.

REST-методы

Методы сервиса

TradingSchedules

Получить расписания торгов торговых площадок.

BondBy

Получить облигации по ее идентификатору.

Bonds

Получить список облигаций.

GetBondCoupons

Получить график выплат купонов по облигации.

GetBondEvents

Получить события по облигации

CurrencyBy

Получить валюту по ее идентификатору.

Currencies

Получить список валют.

EtfBy

Получить инвестиционный фонд по его идентификатору.

Etfs

Получить список инвестиционных фондов.

FutureBy

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

Futures

Получить список фьючерсов.

OptionBy

Получить опцион по его идентификатору.

Options

Deprecated Получить списка опционов.

OptionsBy

Получить список опционов.

ShareBy

Получить акцию по ее идентификатору.

Shares

Получить список акций.

Indicatives

Получить индикативные инструменты — индексы, товары и другие.

GetAccruedInterests

Получить накопленный купонный доход по облигации.

GetFuturesMargin

Получить размера гарантийного обеспечения по фьючерсам.

GetInstrumentBy

Получить основную информацию об инструменте.

GetDividends

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

GetAssetBy

Получить актив по его идентификатору.

GetAssets

Получить список активов. Метод работает для всех инструментов, кроме срочных — фьючерсов и опционов.

GetFavorites

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

EditFavorites

Отредактировать список избранных инструментов.

GetCountries

Получить список стран.

FindInstrument

Найти инструмент.

GetBrands

Получить список брендов.

GetBrandBy

Получить бренд по его идентификатору.

GetAssetFundamentals

Получить фундаментальные показатели по активу.

GetAssetReports

Получить расписания выхода отчетностей эмитентов.

GetConsensusForecasts

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

GetForecastBy

Получить прогнозов инвестдомов по инструменту.

Сообщения методов

TradingSchedulesRequest

Запрос расписания торгов.

FieldTypeDescription
exchangestringНаименование биржи или расчетного календаря.
Если не передается, возвращается информация по всем доступным торговым площадкам.
fromgoogle.protobuf.TimestampНачало периода по UTC.
togoogle.protobuf.TimestampОкончание периода по UTC.

TradingSchedulesResponse

Список торговых площадок.

FieldTypeDescription
exchangesМассив объектов TradingScheduleСписок торговых площадок и режимов торгов.

TradingSchedule

Данные по торговой площадке.

FieldTypeDescription
exchangestringНаименование торговой площадки.
daysМассив объектов TradingDayМассив с торговыми и неторговыми днями.

TradingDay

Информация о времени торгов.

FieldTypeDescription
dategoogle.protobuf.TimestampДата.
is_trading_dayboolПризнак торгового дня на бирже.
start_timegoogle.protobuf.TimestampВремя начала торгов по UTC.
end_timegoogle.protobuf.TimestampВремя окончания торгов по UTC.
opening_auction_start_timegoogle.protobuf.TimestampВремя начала аукциона открытия по UTC.
closing_auction_end_timegoogle.protobuf.TimestampВремя окончания аукциона закрытия по UTC.
evening_opening_auction_start_timegoogle.protobuf.TimestampВремя начала аукциона открытия вечерней сессии по UTC.
evening_start_timegoogle.protobuf.TimestampВремя начала вечерней сессии по UTC.
evening_end_timegoogle.protobuf.TimestampВремя окончания вечерней сессии по UTC.
clearing_start_timegoogle.protobuf.TimestampВремя начала основного клиринга по UTC.
clearing_end_timegoogle.protobuf.TimestampВремя окончания основного клиринга по UTC.
premarket_start_timegoogle.protobuf.TimestampВремя начала премаркета по UTC.
premarket_end_timegoogle.protobuf.TimestampВремя окончания премаркета по UTC.
closing_auction_start_timegoogle.protobuf.TimestampВремя начала аукциона закрытия по UTC.
opening_auction_end_timegoogle.protobuf.TimestampВремя окончания аукциона открытия по UTC.
intervalsМассив объектов TradingIntervalТорговые интервалы.

InstrumentRequest

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

FieldTypeDescription
id_typeInstrumentIdTypeТип идентификатора инструмента. Возможные значения — figi, ticker. Подробнее об идентификации инструментов.
class_codestringИдентификатор class_code. Обязательный, если id_type = ticker.
idstringИдентификатор запрашиваемого инструмента.

InstrumentsRequest

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

FieldTypeDescription
instrument_statusInstrumentStatusСтатус запрашиваемых инструментов. Возможные значения.
instrument_exchangeInstrumentExchangeTypeТип площадки торговли. Возможные значения.

FilterOptionsRequest

Параметры фильтрации опционов.

FieldTypeDescription
basic_asset_uidstringИдентификатор базового актива опциона. Обязательный параметр.
basic_asset_position_uidstringИдентификатор позиции базового актива опциона.

BondResponse

Информация об облигации.

FieldTypeDescription
instrumentBondИнформация об облигации.

BondsResponse

Список облигаций.

FieldTypeDescription
instrumentsМассив объектов BondМассив облигаций.

GetBondCouponsRequest

Запрос купонов по облигации.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
fromgoogle.protobuf.TimestampНачало запрашиваемого периода по UTC. Фильтрация по coupon_date — дата выплаты купона.
togoogle.protobuf.TimestampОкончание запрашиваемого периода по UTC. Фильтрация по coupon_date — дата выплаты купона.
instrument_idstringИдентификатор инструмента — figi или instrument_uid.

GetBondCouponsResponse

Купоны по облигации.

FieldTypeDescription
eventsМассив объектов Coupon

GetBondEventsRequest

События по облигации.

FieldTypeDescription
fromgoogle.protobuf.TimestampНачало запрашиваемого периода по UTC.
togoogle.protobuf.TimestampОкончание запрашиваемого периода по UTC.
instrument_idstringИдентификатор инструмента — figi или instrument_uid.
typeGetBondEventsRequest.EventTypeТип события

GetBondEventsResponse

Объект передачи информации о событии облигации.

FieldTypeDescription
eventsМассив объектов GetBondEventsResponse.BondEvent

GetBondEventsResponse.BondEvent

FieldTypeDescription
instrument_idstringИдентификатор инструмента.
event_numberint32Номер события для данного типа события.
event_dategoogle.protobuf.TimestampДата события.
event_typeGetBondEventsRequest.EventTypeТип события.
event_total_volQuotationПолное количество бумаг, задействованных в событии.
fix_dategoogle.protobuf.TimestampДата фиксации владельцев для участия в событии.
rate_dategoogle.protobuf.TimestampДата определения даты или факта события.
default_dategoogle.protobuf.TimestampДата дефолта, если применимо.
real_pay_dategoogle.protobuf.TimestampДата реального исполнения обязательства.
pay_dategoogle.protobuf.TimestampДата выплаты.
pay_one_bondMoneyValueВыплата на одну облигацию.
money_flow_valMoneyValueВыплаты на все бумаги, задействованные в событии.
executionstringПризнак исполнения.
operation_typestringТип операции.
valueQuotationСтоимость операции — ставка купона, доля номинала, цена выкупа или коэффициент конвертации.
notestringПримечание.
convert_to_fin_tool_idstringID выпуска бумаг, в который произведена конвертация (для конвертаций).
coupon_start_dategoogle.protobuf.TimestampНачало купонного периода.
coupon_end_dategoogle.protobuf.TimestampОкончание купонного периода.
coupon_periodint32Купонный период.
coupon_interest_rateQuotationСтавка купона, процентов годовых.

Coupon

Объект передачи информации о купоне облигации.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
coupon_dategoogle.protobuf.TimestampДата выплаты купона.
coupon_numberint64Номер купона.
fix_dategoogle.protobuf.TimestampДата фиксации реестра для выплаты купона — опционально.
pay_one_bondMoneyValueВыплата на одну облигацию.
coupon_typeCouponTypeТип купона.
coupon_start_dategoogle.protobuf.TimestampНачало купонного периода.
coupon_end_dategoogle.protobuf.TimestampОкончание купонного периода.
coupon_periodint32Купонный период в днях.

CurrencyResponse

Данные по валюте.

FieldTypeDescription
instrumentCurrencyИнформация о валюте.

CurrenciesResponse

Данные по валютам.

FieldTypeDescription
instrumentsМассив объектов CurrencyМассив валют.

EtfResponse

Данные по фонду.

FieldTypeDescription
instrumentEtfИнформация о фонде.

EtfsResponse

Данные по фондам.

FieldTypeDescription
instrumentsМассив объектов EtfМассив фондов.

FutureResponse

Данные по фьючерсу.

FieldTypeDescription
instrumentFutureИнформация о фьючерсу.

FuturesResponse

Данные по фьючерсам.

FieldTypeDescription
instrumentsМассив объектов FutureМассив фьючерсов.

OptionResponse

Данные по опциону.

FieldTypeDescription
instrumentOptionИнформация по опциону.

OptionsResponse

Данные по опционам.

FieldTypeDescription
instrumentsМассив объектов OptionМассив данных по опциону.

Option

Опцион.

FieldTypeDescription
uidstringУникальный идентификатор инструмента.
position_uidstringУникальный идентификатор позиции.
tickerstringТикер инструмента.
class_codestringКласс-код.
basic_asset_position_uidstringУникальный идентификатор позиции основного инструмента.
trading_statusSecurityTradingStatusТекущий режим торгов инструмента.
real_exchangeRealExchangeРеальная площадка исполнения расчетов (биржа).
directionOptionDirectionНаправление опциона.
payment_typeOptionPaymentTypeТип расчетов по опциону.
styleOptionStyleСтиль опциона.
settlement_typeOptionSettlementTypeСпособ исполнения опциона.
namestringНазвание инструмента.
currencystringВалюта.
settlement_currencystringВалюта, в которой оценивается контракт.
asset_typestringТип актива.
basic_assetstringОсновной актив.
exchangestringTорговая площадка (секция биржи).
country_of_riskstringКод страны рисков.
country_of_risk_namestringНаименование страны рисков.
sectorstringСектор экономики.
brandBrandDataИнформация о бренде.
lotint32Количество бумаг в лоте.
basic_asset_sizeQuotationРазмер основного актива.
klongQuotationКоэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
kshortQuotationКоэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
dlongQuotationСтавка риска начальной маржи для КСУР лонг. Подробнее про ставки риска.
dshortQuotationСтавка риска начальной маржи для КСУР шорт. Подробнее про ставки риска.
dlong_minQuotationСтавка риска начальной маржи для КПУР лонг. Подробнее про ставки риска.
dshort_minQuotationСтавка риска начальной маржи для КПУР шорт. Подробнее про ставки риска.
min_price_incrementQuotationМинимальный шаг цены.
strike_priceMoneyValueЦена страйка.
dlong_clientQuotationСтавка риска в лонг с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
dshort_clientQuotationСтавка риска в шорт с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
expiration_dategoogle.protobuf.TimestampДата истечения срока в формате UTC.
first_trade_dategoogle.protobuf.TimestampДата начала обращения контракта в формате UTC.
last_trade_dategoogle.protobuf.TimestampДата исполнения в формате UTC.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи в формате UTC.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи в формате UTC.
short_enabled_flagboolПризнак доступности для операций шорт.
for_iis_flagboolВозможность покупки или продажи на ИИС.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
api_trade_available_flagboolВозможность торговать инструментом через API.

ShareResponse

Данные по акции.

FieldTypeDescription
instrumentShareИнформация об акции.

SharesResponse

Данные по акциям.

FieldTypeDescription
instrumentsМассив объектов ShareМассив акций.

Bond

Объект передачи информации об облигации.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код (секция торгов).
isinstringISIN-идентификатор инструмента.
lotint32Лотность инструмента. Возможно совершение операций только на количества ценной бумаги, кратные параметру lot. Подробнее.
currencystringВалюта расчетов.
klongQuotationКоэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
kshortQuotationКоэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
dlongQuotationСтавка риска начальной маржи для КСУР лонг. Подробнее про ставки риска.
dshortQuotationСтавка риска начальной маржи для КСУР шорт. Подробнее про ставки риска.
dlong_minQuotationСтавка риска начальной маржи для КПУР лонг. Подробнее про ставки риска.
dshort_minQuotationСтавка риска начальной маржи для КПУР шорт. Подробнее про ставки риска.
short_enabled_flagboolПризнак доступности для операций в шорт.
namestringНазвание инструмента.
exchangestringTорговая площадка (секция биржи).
coupon_quantity_per_yearint32Количество выплат по купонам в год.
maturity_dategoogle.protobuf.TimestampДата погашения облигации по UTC.
nominalMoneyValueНоминал облигации.
initial_nominalMoneyValueПервоначальный номинал облигации.
state_reg_dategoogle.protobuf.TimestampДата выпуска облигации по UTC.
placement_dategoogle.protobuf.TimestampДата размещения по UTC.
placement_priceMoneyValueЦена размещения.
aci_valueMoneyValueЗначение НКД (накопленного купонного дохода) на дату.
country_of_riskstringКод страны риска — то есть страны, в которой компания ведет основной бизнес.
country_of_risk_namestringНаименование страны риска — то есть страны, в которой компания ведет основной бизнес.
sectorstringСектор экономики.
issue_kindstringФорма выпуска. Возможные значения:
documentary — документарная;
non_documentary — бездокументарная.
issue_sizeint64Размер выпуска.
issue_size_planint64Плановый размер выпуска.
trading_statusSecurityTradingStatusТекущий режим торгов инструмента.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.
floating_coupon_flagboolПризнак облигации с плавающим купоном.
perpetual_flagboolПризнак бессрочной облигации.
amortization_flagboolПризнак облигации с амортизацией долга.
min_price_incrementQuotationШаг цены.
api_trade_available_flagboolПараметр указывает на возможность торговать инструментом через API.
uidstringУникальный идентификатор инструмента.
real_exchangeRealExchangeРеальная площадка исполнения расчетов. (биржа)
position_uidstringУникальный идентификатор позиции инструмента.
asset_uidstringУникальный идентификатор актива.
for_iis_flagboolПризнак доступности для ИИС.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
subordinated_flagboolПризнак субординированной облигации.
liquidity_flagboolФлаг достаточной ликвидности.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи.
risk_levelRiskLevelУровень риска.
brandBrandDataИнформация о бренде.
bond_typeBondTypeТип облигации.
call_dategoogle.protobuf.TimestampДата погашения облигации.
dlong_clientQuotationСтавка риска в лонг с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
dshort_clientQuotationСтавка риска в шорт с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.

Currency

Объект передачи информации о валюте.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код (секция торгов).
isinstringISIN-идентификатор инструмента.
lotint32Лотность инструмента. Возможно совершение операций только на количества ценной бумаги, кратные параметру lot. Подробнее.
currencystringВалюта расчетов.
klongQuotationКоэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
kshortQuotationКоэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
dlongQuotationСтавка риска начальной маржи для КСУР лонг. Подробнее про ставки риска.
dshortQuotationСтавка риска начальной маржи для КСУР шорт. Подробнее про ставки риска.
dlong_minQuotationСтавка риска начальной маржи для КПУР лонг. Подробнее про ставки риска.
dshort_minQuotationСтавка риска начальной маржи для КПУР шорт. Подробнее про ставки риска.
short_enabled_flagboolПризнак доступности для операций в шорт.
namestringНазвание инструмента.
exchangestringTорговая площадка (секция биржи).
nominalMoneyValueНоминал.
country_of_riskstringКод страны риска — то есть страны, в которой компания ведет основной бизнес.
country_of_risk_namestringНаименование страны риска — то есть страны, в которой компания ведет основной бизнес.
trading_statusSecurityTradingStatusТекущий режим торгов инструмента.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.
iso_currency_namestringСтроковый ISO-код валюты.
min_price_incrementQuotationШаг цены.
api_trade_available_flagboolПараметр указывает на возможность торговать инструментом через API.
uidstringУникальный идентификатор инструмента.
real_exchangeRealExchangeРеальная площадка исполнения расчетов (биржа).
dlong_clientQuotationСтавка риска в лонг с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
dshort_clientQuotationСтавка риска в шорт с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
position_uidstringУникальный идентификатор позиции инструмента.
for_iis_flagboolПризнак доступности для ИИС.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи.
brandBrandDataИнформация о бренде.

Etf

Объект передачи информации об инвестиционном фонде.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код (секция торгов).
isinstringISIN-идентификатор инструмента.
lotint32Лотность инструмента. Возможно совершение операций только на количества ценной бумаги, кратные параметру lot. Подробнее.
currencystringВалюта расчетов.
klongQuotationКоэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
kshortQuotationКоэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
dlongQuotationСтавка риска начальной маржи для КСУР лонг. Подробнее про ставки риска.
dshortQuotationСтавка риска начальной маржи для КСУР шорт. Подробнее про ставки риска.
dlong_minQuotationСтавка риска начальной маржи для КПУР лонг. Подробнее про ставки риска.
dshort_minQuotationСтавка риска начальной маржи для КПУР шорт. Подробнее про ставки риска.
short_enabled_flagboolПризнак доступности для операций в шорт.
namestringНазвание инструмента.
exchangestringTорговая площадка (секция биржи).
fixed_commissionQuotationРазмер фиксированной комиссии фонда.
focus_typestringВозможные значения:
equity — акции;
fixed_income — облигации;
mixed_allocation — смешанный;
money_market — денежный рынок;
real_estate — недвижимость;
commodity — товары;
specialty — специальный;
private_equity — private equity;
alternative_investment — альтернативные инвестиции.
released_dategoogle.protobuf.TimestampДата выпуска по UTC.
num_sharesQuotationКоличество паев фонда в обращении.
country_of_riskstringКод страны риска — то есть страны, в которой компания ведет основной бизнес.
country_of_risk_namestringНаименование страны риска — то есть страны, в которой компания ведет основной бизнес.
sectorstringСектор экономики.
rebalancing_freqstringЧастота ребалансировки.
trading_statusSecurityTradingStatusТекущий режим торгов инструмента.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.
min_price_incrementQuotationШаг цены.
api_trade_available_flagboolПараметр указывает на возможность торговать инструментом через API.
uidstringУникальный идентификатор инструмента.
real_exchangeRealExchangeРеальная площадка исполнения расчетов (биржа).
position_uidstringУникальный идентификатор позиции инструмента.
asset_uidstringУникальный идентификатор актива.
instrument_exchangeInstrumentExchangeTypeТип площадки торговли.
for_iis_flagboolПризнак доступности для ИИС.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлагФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
liquidity_flagboolФлаг достаточной ликвидности.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи.
brandBrandDataИнформация о бренде.
dlong_clientQuotationСтавка риска в лонг с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
dshort_clientQuotationСтавка риска в шорт с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.

Future

Объект передачи информации о фьючерсе.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код (секция торгов).
lotint32Лотность инструмента. Возможно совершение операций только на количества ценной бумаги, кратные параметру lot. Подробнее.
currencystringВалюта расчетов.
klongQuotationКоэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
kshortQuotationКоэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
dlongQuotationСтавка риска начальной маржи для КСУР лонг. Подробнее про ставки риска.
dshortQuotationСтавка риска начальной маржи для КСУР шорт. Подробнее про ставки риска.
dlong_minQuotationСтавка риска начальной маржи для КПУР лонг. Подробнее про ставки риска.
dshort_minQuotationСтавка риска начальной маржи для КПУР шорт. Подробнее про ставки риска.
short_enabled_flagboolПризнак доступности для операций шорт.
namestringНазвание инструмента.
exchangestringTорговая площадка (секция биржи).
first_trade_dategoogle.protobuf.TimestampДата начала обращения контракта по UTC.
last_trade_dategoogle.protobuf.TimestampДата по UTC, до которой возможно проведение операций с фьючерсом.
futures_typestringТип фьючерса. Возможные значения:
physical_delivery — физические поставки;
cash_settlement — денежный эквивалент.
asset_typestringТип актива. Возможные значения:
commodity — товар;
currency — валюта;
security — ценная бумага;
index — индекс.
basic_assetstringОсновной актив.
basic_asset_sizeQuotationРазмер основного актива.
country_of_riskstringКод страны риска — то есть страны, в которой компания ведет основной бизнес.
country_of_risk_namestringНаименование страны риска — то есть страны, в которой компания ведет основной бизнес.
sectorstringСектор экономики.
expiration_dategoogle.protobuf.TimestampДата истечения срока в часов поясе UTC.
trading_statusSecurityTradingStatusТекущий режим торгов инструмента.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.
min_price_incrementQuotationШаг цены.
api_trade_available_flagboolПараметр указывает на возможность торговать инструментом через API.
uidstringУникальный идентификатор инструмента.
real_exchangeRealExchangeРеальная площадка исполнения расчетов (биржа).
position_uidstringУникальный идентификатор позиции инструмента.
basic_asset_position_uidstringУникальный идентификатор позиции основного инструмента.
for_iis_flagboolПризнак доступности для ИИС.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи.
initial_margin_on_buyMoneyValueГарантийное обеспечение при покупке.
initial_margin_on_sellMoneyValueГарантийное обеспечение при продаже.
min_price_increment_amountQuotationСтоимость шага цены.
brandBrandDataИнформация о бренде.
dlong_clientQuotationСтавка риска в лонг с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
dshort_clientQuotationСтавка риска в шорт с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.

Share

Объект передачи информации об акции.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код (секция торгов).
isinstringISIN-идентификатор инструмента.
lotint32Лотность инструмента. Возможно совершение операций только на количества ценной бумаги, кратные параметру lot. Подробнее
currencystringВалюта расчетов.
klongQuotationКоэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
kshortQuotationКоэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
dlongQuotationСтавка риска начальной маржи для КСУР лонг. Подробнее про ставки риска.
dshortQuotationСтавка риска начальной маржи для КСУР шорт. Подробнее про ставки риска.
dlong_minQuotationСтавка риска начальной маржи для КПУР лонг. Подробнее про ставки риска.
dshort_minQuotationСтавка риска начальной маржи для КПУР шорт. Подробнее про ставки риска.
short_enabled_flagboolПризнак доступности для операций в шорт.
namestringНазвание инструмента.
exchangestringTорговая площадка (секция биржи).
ipo_dategoogle.protobuf.TimestampДата IPO акции по UTC.
issue_sizeint64Размер выпуска.
country_of_riskstringКод страны риска — то есть страны, в которой компания ведет основной бизнес.
country_of_risk_namestringНаименование страны риска — то есть страны, в которой компания ведет основной бизнес.
sectorstringСектор экономики.
issue_size_planint64Плановый размер выпуска.
nominalMoneyValueНоминал.
trading_statusSecurityTradingStatusТекущий режим торгов инструмента.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.
div_yield_flagboolПризнак наличия дивидендной доходности.
share_typeShareTypeТип акции. Возможные значения — [ShareType](/invest/services/instruments/methods#sharetype).
min_price_incrementQuotationШаг цены.
api_trade_available_flagboolВозможность торговать инструментом через API.
uidstringУникальный идентификатор инструмента.
real_exchangeRealExchangeРеальная площадка исполнения расчетов (биржа).
position_uidstringУникальный идентификатор позиции инструмента.
asset_uidstringУникальный идентификатор актива.
instrument_exchangeInstrumentExchangeTypeТип площадки торговли.
for_iis_flagboolПризнак доступности для ИИС.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
liquidity_flagboolФлаг достаточной ликвидности.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи.
brandBrandDataИнформация о бренде.
dlong_clientQuotationСтавка риска в лонг с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
dshort_clientQuotationСтавка риска в шорт с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.

GetAccruedInterestsRequest

Запрос НКД по облигации.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
fromgoogle.protobuf.TimestampНачало запрашиваемого периода по UTC.
togoogle.protobuf.TimestampОкончание запрашиваемого периода по UTC.
instrument_idstringИдентификатор инструмента — figi или instrument_uid.

GetAccruedInterestsResponse

НКД облигации.

FieldTypeDescription
accrued_interestsМассив объектов AccruedInterestМассив операций начисления купонов.

AccruedInterest

Операция начисления купонов.

FieldTypeDescription
dategoogle.protobuf.TimestampДата и время выплаты по UTC.
valueQuotationВеличина выплаты.
value_percentQuotationВеличина выплаты в процентах от номинала.
nominalQuotationНоминал облигации.

GetFuturesMarginRequest

Запрос информации о фьючерсе

FieldTypeDescription
figistringИдентификатор инструмента.
instrument_idstringИдентификатор инструмента — figi или instrument_uid.

GetFuturesMarginResponse

Данные по фьючерсу

FieldTypeDescription
initial_margin_on_buyMoneyValueГарантийное обеспечение при покупке.
initial_margin_on_sellMoneyValueГарантийное обеспечение при продаже.
min_price_incrementQuotationШаг цены.
min_price_increment_amountQuotationСтоимость шага цены.

InstrumentResponse

Данные по инструменту.

FieldTypeDescription
instrumentInstrumentОсновная информация об инструменте.

Instrument

Объект передачи основной информации об инструменте.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код инструмента.
isinstringISIN-идентификатор инструмента.
lotint32Лотность инструмента. Возможно совершение операций только на количества ценной бумаги, кратные параметру lot. Подробнее.
currencystringВалюта расчетов.
klongQuotationКоэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
kshortQuotationКоэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР); 1 – клиент с повышенным уровнем риска (КПУР).
dlongQuotationСтавка риска начальной маржи для КСУР лонг. Подробнее про ставки риска.
dshortQuotationСтавка риска начальной маржи для КСУР шорт. Подробнее про ставки риска.
dlong_minQuotationСтавка риска начальной маржи для КПУР лонг. Подробнее про ставки риска.
dshort_minQuotationСтавка риска начальной маржи для КПУР шорт. Подробнее про ставки риска.
short_enabled_flagboolПризнак доступности для операций в шорт.
namestringНазвание инструмента.
exchangestringTорговая площадка (секция биржи).
country_of_riskstringКод страны риска — то есть страны, в которой компания ведет основной бизнес.
country_of_risk_namestringНаименование страны риска — то есть страны, в которой компания ведет основной бизнес.
instrument_typestringТип инструмента.
trading_statusSecurityTradingStatusТекущий режим торгов инструмента.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.
min_price_incrementQuotationШаг цены.
api_trade_available_flagboolПараметр указывает на возможность торговать инструментом через API.
uidstringУникальный идентификатор инструмента.
real_exchangeRealExchangeРеальная площадка исполнения расчетов (биржа).
position_uidstringУникальный идентификатор позиции инструмента.
asset_uidstringУникальный идентификатор актива.
for_iis_flagboolПризнак доступности для ИИС.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
instrument_kindInstrumentTypeТип инструмента.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи.
brandBrandDataИнформация о бренде.
dlong_clientQuotationСтавка риска в лонг с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.
dshort_clientQuotationСтавка риска в шорт с учетом текущего уровня риска портфеля клиента. Подробнее про ставки риска.

GetDividendsRequest

Запрос дивидендов.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
fromgoogle.protobuf.TimestampНачало запрашиваемого периода по UTC. Фильтрация происходит по параметру record_date — дата фиксации реестра.
togoogle.protobuf.TimestampОкончание запрашиваемого периода по UTC. Фильтрация происходит по параметру record_date — дата фиксации реестра.
instrument_idstringИдентификатор инструмента — figi или instrument_uid.

GetDividendsResponse

Дивиденды.

FieldTypeDescription
dividendsМассив объектов Dividend

Dividend

Информация о выплате.

FieldTypeDescription
dividend_netMoneyValueВеличина дивиденда на 1 ценную бумагу (включая валюту).
payment_dategoogle.protobuf.TimestampДата фактических выплат по UTC.
declared_dategoogle.protobuf.TimestampДата объявления дивидендов по UTC.
last_buy_dategoogle.protobuf.TimestampПоследний день (включительно) покупки для получения выплаты по UTC.
dividend_typestringТип выплаты. Возможные значения: Regular Cash – регулярные выплаты, Cancelled – выплата отменена, Daily Accrual – ежедневное начисление, Return of Capital – возврат капитала, прочие типы выплат.
record_dategoogle.protobuf.TimestampДата фиксации реестра по UTC.
regularitystringРегулярность выплаты. Возможные значения: Annual – ежегодная, Semi-Anl – каждые полгода, прочие типы выплат.
close_priceMoneyValueЦена закрытия инструмента на момент ex_dividend_date.
yield_valueQuotationВеличина доходности.
created_atgoogle.protobuf.TimestampДата и время создания записи по UTC.

AssetRequest

Запрос актива по идентификатору.

FieldTypeDescription
idstringUID-идентификатор актива.

AssetResponse

Данные по активу.

FieldTypeDescription
assetAssetFullАктив.

AssetsRequest

Запрос списка активов.

FieldTypeDescription
instrument_typeInstrumentType
instrument_statusInstrumentStatusСтатус запрашиваемых инструментов. Возможные значения.

AssetsResponse

Список активов.

FieldTypeDescription
assetsМассив объектов AssetАктивы.

AssetFull

FieldTypeDescription
uidstringУникальный идентификатор актива.
typeAssetTypeТип актива.
namestringНаименование актива.
name_briefstringКороткое наименование актива.
descriptionstringОписание актива.
deleted_atgoogle.protobuf.TimestampДата и время удаления актива.
required_testsМассив объектов stringТестирование клиентов.
currencyAssetCurrencyВалюта. Обязательно и заполняется только для type = ASSET_TYPE_CURRENCY.
securityAssetSecurityЦенная бумага. Обязательно и заполняется только для type = ASSET_TYPE_SECURITY.
gos_reg_codestringНомер государственной регистрации.
cfistringКод CFI.
code_nsdstringКод НРД инструмента.
statusstringСтатус актива.
brandBrandБренд.
updated_atgoogle.protobuf.TimestampДата и время последнего обновления записи.
br_codestringКод типа ц.б. по классификации Банка России.
br_code_namestringНаименование кода типа ц.б. по классификации Банка России.
instrumentsМассив объектов AssetInstrumentМассив идентификаторов инструментов.

Asset

Информация об активе.

FieldTypeDescription
uidstringУникальный идентификатор актива.
typeAssetTypeТип актива.
namestringНаименование актива.
instrumentsМассив объектов AssetInstrumentМассив идентификаторов инструментов.

AssetCurrency

Валюта.

FieldTypeDescription
base_currencystringISO-код валюты.

AssetSecurity

Ценная бумага.

FieldTypeDescription
isinstringISIN-идентификатор ценной бумаги.
typestringТип ценной бумаги.
instrument_kindInstrumentTypeТип инструмента.
shareAssetShareАкция. Заполняется только для акций — тип актива asset.type = ASSET_TYPE_SECURITY и security.type = share.
bondAssetBondОблигация. Заполняется только для облигаций — тип актива asset.type = ASSET_TYPE_SECURITY и security.type = bond.
spAssetStructuredProductСтруктурная нота. Заполняется только для структурных продуктов — тип актива asset.type = ASSET_TYPE_SECURITY и security.type = sp.
etfAssetEtfФонд. Заполняется только для фондов — тип актива asset.type = ASSET_TYPE_SECURITY и security.type = etf.
clearing_certificateAssetClearingCertificateКлиринговый сертификат участия. Заполняется только для клиринговых сертификатов — тип актива asset.type = ASSET_TYPE_SECURITY и security.type = clearing_certificate.

AssetShare

Акция.

FieldTypeDescription
typeShareTypeТип акции.
issue_sizeQuotationОбъем выпуска (шт.).
nominalQuotationНоминал.
nominal_currencystringВалюта номинала.
primary_indexstringИндекс (Bloomberg).
dividend_rateQuotationСтавка дивиденда (для привилегированных акций).
preferred_share_typestringТип привилегированных акций.
ipo_dategoogle.protobuf.TimestampДата IPO.
registry_dategoogle.protobuf.TimestampДата регистрации.
div_yield_flagboolПризнак наличия дивидендной доходности.
issue_kindstringФорма выпуска ФИ.
placement_dategoogle.protobuf.TimestampДата размещения акции.
repres_isinstringISIN базового актива.
issue_size_planQuotationОбъявленное количество, шт.
total_floatQuotationКоличество акций в свободном обращении.

AssetBond

Облигация.

FieldTypeDescription
current_nominalQuotationТекущий номинал.
borrow_namestringНаименование заемщика.
issue_sizeQuotationОбъем эмиссии облигации (стоимость).
nominalQuotationНоминал облигации.
nominal_currencystringВалюта номинала.
issue_kindstringФорма выпуска облигации.
interest_kindstringФорма дохода облигации.
coupon_quantity_per_yearint32Количество выплат в год.
indexed_nominal_flagboolПризнак облигации с индексируемым номиналом.
subordinated_flagboolПризнак субординированной облигации.
collateral_flagboolПризнак обеспеченной облигации.
tax_free_flagboolПризнак показывает, что купоны облигации не облагаются налогом — для mass market.
amortization_flagboolПризнак облигации с амортизацией долга.
floating_coupon_flagboolПризнак облигации с плавающим купоном.
perpetual_flagboolПризнак бессрочной облигации.
maturity_dategoogle.protobuf.TimestampДата погашения облигации.
return_conditionstringОписание и условия получения дополнительного дохода.
state_reg_dategoogle.protobuf.TimestampДата выпуска облигации.
placement_dategoogle.protobuf.TimestampДата размещения облигации.
placement_priceQuotationЦена размещения облигации.
issue_size_planQuotationОбъявленное количество, шт.

AssetStructuredProduct

Структурная нота.

FieldTypeDescription
borrow_namestringНаименование заемщика.
nominalQuotationНоминал.
nominal_currencystringВалюта номинала.
typeStructuredProductTypeТип структурной ноты.
logic_portfoliostringСтратегия портфеля.
asset_typeAssetTypeТип базового актива.
basic_assetstringВид базового актива в зависимости от типа базового актива.
safety_barrierQuotationБарьер сохранности в процентах.
maturity_dategoogle.protobuf.TimestampДата погашения.
issue_size_planQuotationОбъявленное количество, шт.
issue_sizeQuotationОбъем размещения.
placement_dategoogle.protobuf.TimestampДата размещения ноты.
issue_kindstringФорма выпуска.

AssetEtf

Фонд.

FieldTypeDescription
total_expenseQuotationСуммарные расходы фонда в процентах.
hurdle_rateQuotationБарьерная ставка доходности, после которой фонд имеет право на perfomance fee — в процентах.
performance_feeQuotationКомиссия за успешные результаты фонда в процентах.
fixed_commissionQuotationФиксированная комиссия за управление в процентах.
payment_typestringТип распределения доходов от выплат по бумагам.
watermark_flagboolПризнак необходимости выхода фонда в плюс для получения комиссии.
buy_premiumQuotationПремия (надбавка к цене) при покупке доли в фонде — в процентах.
sell_discountQuotationСтавка дисконта (вычет из цены) при продаже доли в фонде — в процентах.
rebalancing_flagboolПризнак ребалансируемости портфеля фонда.
rebalancing_freqstringПериодичность ребалансировки.
management_typestringТип управления.
primary_indexstringИндекс, который реплицирует (старается копировать) фонд.
focus_typestringБаза ETF.
leveraged_flagboolПризнак использования заемных активов (плечо).
num_shareQuotationКоличество акций в обращении.
ucits_flagboolПризнак обязательства по отчетности перед регулятором.
released_dategoogle.protobuf.TimestampДата выпуска.
descriptionstringОписание фонда.
primary_index_descriptionstringОписание индекса, за которым следует фонд.
primary_index_companystringОсновные компании, в которые вкладывается фонд.
index_recovery_periodQuotationСрок восстановления индекса после просадки.
inav_codestringIVAV-код.
div_yield_flagboolПризнак наличия дивидендной доходности.
expense_commissionQuotationКомиссия на покрытие расходов фонда в процентах.
primary_index_tracking_errorQuotationОшибка следования за индексом в процентах.
rebalancing_planstringПлановая ребалансировка портфеля.
tax_ratestringСтавки налогообложения дивидендов и купонов.
rebalancing_datesМассив объектов google.protobuf.TimestampДаты ребалансировок.
issue_kindstringФорма выпуска.
nominalQuotationНоминал.
nominal_currencystringВалюта номинала.

AssetClearingCertificate

Клиринговый сертификат участия.

FieldTypeDescription
nominalQuotationНоминал.
nominal_currencystringВалюта номинала.

Brand

Бренд.

FieldTypeDescription
uidstringUID-идентификатор бренда.
namestringНаименование бренда.
descriptionstringОписание.
infostringИнформация о бренде.
companystringКомпания.
sectorstringСектор.
country_of_riskstringКод страны риска.
country_of_risk_namestringНаименование страны риска.

AssetInstrument

Идентификаторы инструмента.

FieldTypeDescription
uidstringUID-идентификатор инструмента.
figistringFIGI-идентификатор инструмента.
instrument_typestringТип инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код (секция торгов).
linksМассив объектов InstrumentLinkМассив связанных инструментов.
instrument_kindInstrumentTypeТип инструмента.
position_uidstringID позиции.

Связь с другим инструментом.

FieldTypeDescription
typestringТип связи.
instrument_uidstringUID-идентификатор связанного инструмента.

GetFavoritesRequest

Запрос списка избранных инструментов, входные параметры не требуются.

GetFavoritesResponse

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

FieldTypeDescription
favorite_instrumentsМассив объектов FavoriteInstrumentМассив инструментов.

FavoriteInstrument

Массив избранных инструментов.

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код инструмента.
isinstringISIN-идентификатор инструмента.
instrument_typestringТип инструмента.
namestringНазвание инструмента.
uidstringУникальный идентификатор инструмента.
otc_flagboolФлаг, используемый ранее для определения внебиржевых инструментов. На данный момент не используется для торгуемых через API инструментов. Может использоваться как фильтр для операций, совершавшихся некоторое время назад на ОТС площадке.
api_trade_available_flagboolВозможность торговать инструментом через API.
instrument_kindInstrumentTypeТип инструмента.

EditFavoritesRequest

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

FieldTypeDescription
instrumentsМассив объектов EditFavoritesRequestInstrumentМассив инструментов.
action_typeEditFavoritesActionTypeТип действия со списком.

EditFavoritesRequestInstrument

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

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
instrument_idstringИдентификатор инструмента — figi или instrument_uid.

EditFavoritesResponse

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

FieldTypeDescription
favorite_instrumentsМассив объектов FavoriteInstrumentМассив инструментов.

GetCountriesRequest

Запрос справочника стран.

GetCountriesResponse

Справочник стран.

FieldTypeDescription
countriesМассив объектов CountryResponseМассив стран.

IndicativesRequest

Запрос справочника индексов и товаров

IndicativesResponse

Справочник индексов и товаров

FieldTypeDescription
instrumentsМассив объектов IndicativeResponseМассив инструментов.

IndicativeResponse

Индикатив

FieldTypeDescription
figistringFIGI-идентификатор инструмента.
tickerstringТикер инструмента.
class_codestringКласс-код инструмента.
currencystringВалюта расчетов.
instrument_kindInstrumentTypeТип инструмента.
namestringНазвание инструмента.
exchangestringTорговая площадка (секция биржи).
uidstringУникальный идентификатор инструмента.
buy_available_flagboolПризнак доступности для покупки.
sell_available_flagboolПризнак доступности для продажи.

CountryResponse

Данные о стране.

FieldTypeDescription
alfa_twostringДвухбуквенный код страны.
alfa_threestringТрехбуквенный код страны.
namestringНаименование страны.
name_briefstringКраткое наименование страны.

FindInstrumentRequest

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

FieldTypeDescription
querystringСтрока поиска.
instrument_kindInstrumentTypeФильтр по типу инструмента.
api_trade_available_flagboolФильтр для отображения только торговых инструментов.

FindInstrumentResponse

Результат поиска инструментов.

FieldTypeDescription
instrumentsМассив объектов InstrumentShortМассив инструментов, удовлетворяющих условиям поиска.

InstrumentShort

Краткая информация об инструменте.

FieldTypeDescription
isinstringISIN инструмента.
figistringFIGI инструмента.
tickerstringTicker инструмента.
class_codestringClassCode инструмента.
instrument_typestringТип инструмента.
namestringНазвание инструмента.
uidstringУникальный идентификатор инструмента.
position_uidstringУникальный идентификатор позиции инструмента.
instrument_kindInstrumentTypeТип инструмента.
api_trade_available_flagboolВозможность торговать инструментом через API.
for_iis_flagboolПризнак доступности для ИИС.
first_1min_candle_dategoogle.protobuf.TimestampДата первой минутной свечи.
first_1day_candle_dategoogle.protobuf.TimestampДата первой дневной свечи.
for_qual_investor_flagboolФлаг, отображающий доступность торговли инструментом только для квалифицированных инвесторов.
weekend_flagboolФлаг, отображающий доступность торговли инструментом по выходным.
blocked_tca_flagboolФлаг заблокированного ТКС.
lotint32Количество бумаг в лоте.

GetBrandsRequest

Запрос списка брендов.

FieldTypeDescription
pagingPageНастройки пагинации.

GetBrandRequest

Запрос бренда.

FieldTypeDescription
idstringUID-идентификатор бренда.

GetBrandsResponse

Список брендов.

FieldTypeDescription
brandsМассив объектов BrandМассив брендов.
pagingPageResponseДанные по пагинации.

GetAssetFundamentalsRequest

Запрос фундаментальных показателей

FieldTypeDescription
assetsМассив объектов stringМассив идентификаторов активов, не более 100 шт.

GetAssetFundamentalsResponse

Фундаментальные показатели

FieldTypeDescription
fundamentalsМассив объектов GetAssetFundamentalsResponse.StatisticResponse

GetAssetFundamentalsResponse.StatisticResponse

Фундаментальные показатели по активу

FieldTypeDescription
asset_uidstringИдентификатор актива.
currencystringВалюта.
market_capitalizationdoubleРыночная капитализация.
high_price_last_52_weeksdoubleМаксимум за год.
low_price_last_52_weeksdoubleМинимум за год.
average_daily_volume_last_10_daysdoubleСредний объем торгов за 10 дней.
average_daily_volume_last_4_weeksdoubleСредний объем торгов за месяц.
betadouble
free_floatdoubleДоля акций в свободном обращении.
forward_annual_dividend_yielddoubleПроцент форвардной дивидендной доходности по отношению к цене акций.
shares_outstandingdoubleКоличество акций в обращении.
revenue_ttmdoubleВыручка.
ebitda_ttmdoubleEBITDA — прибыль до вычета процентов, налогов, износа и амортизации.
net_income_ttmdoubleЧистая прибыль.
eps_ttmdoubleEPS — величина чистой прибыли компании, которая приходится на каждую обыкновенную акцию.
diluted_eps_ttmdoubleEPS компании с допущением, что все конвертируемые ценные бумаги компании были сконвертированы в обыкновенные акции.
free_cash_flow_ttmdoubleСвободный денежный поток.
five_year_annual_revenue_growth_ratedoubleСреднегодовой рocт выручки за 5 лет.
three_year_annual_revenue_growth_ratedoubleСреднегодовой рocт выручки за 3 года.
pe_ratio_ttmdoubleСоотношение рыночной капитализации компании к ее чистой прибыли.
price_to_sales_ttmdoubleСоотношение рыночной капитализации компании к ее выручке.
price_to_book_ttmdoubleСоотношение рыночной капитализации компании к ее балансовой стоимости.
price_to_free_cash_flow_ttmdoubleСоотношение рыночной капитализации компании к ее свободному денежному потоку.
total_enterprise_value_mrqdoubleРыночная стоимость компании.
ev_to_ebitda_mrqdoubleСоотношение EV и EBITDA.
net_margin_mrqdoubleМаржа чистой прибыли.
net_interest_margin_mrqdoubleРентабельность чистой прибыли.
roedoubleРентабельность собственного капитала.
roadoubleРентабельность активов.
roicdoubleРентабельность активов.
total_debt_mrqdoubleСумма краткосрочных и долгосрочных обязательств компании.
total_debt_to_equity_mrqdoubleСоотношение долга к собственному капиталу.
total_debt_to_ebitda_mrqdoubleTotal Debt/EBITDA.
free_cash_flow_to_pricedoubleОтношение свободногоо кэша к стоимости.
net_debt_to_ebitdadoubleОтношение чистого долга к EBITDA.
current_ratio_mrqdoubleКоэффициент текущей ликвидности.
fixed_charge_coverage_ratio_fydoubleКоэффициент покрытия фиксированных платежей — FCCR.
dividend_yield_daily_ttmdoubleДивидендная доходность за 12 месяцев.
dividend_rate_ttmdoubleВыплаченные дивиденды за 12 месяцев.
dividends_per_sharedoubleЗначение дивидендов на акцию.
five_years_average_dividend_yielddoubleСредняя дивидендная доходность за 5 лет.
five_year_annual_dividend_growth_ratedoubleСреднегодовой рост дивидендов за 5 лет.
dividend_payout_ratio_fydoubleПроцент чистой прибыли, уходящий на выплату дивидендов.
buy_back_ttmdoubleДеньги, потраченные на обратный выкуп акций.
one_year_annual_revenue_growth_ratedoubleРост выручки за 1 год.
domicile_indicator_codestringКод страны.
adr_to_common_share_ratiodoubleСоотношение депозитарной расписки к акциям.
number_of_employeesdoubleКоличество сотрудников.
ex_dividend_dategoogle.protobuf.Timestamp
fiscal_period_start_dategoogle.protobuf.TimestampНачало фискального периода.
fiscal_period_end_dategoogle.protobuf.TimestampОкончание фискального периода.
revenue_change_five_yearsdoubleИзменение общего дохода за 5 лет.
eps_change_five_yearsdoubleИзменение EPS за 5 лет.
ebitda_change_five_yearsdoubleИзменение EBIDTA за 5 лет.
total_debt_change_five_yearsdoubleИзменение общей задолжности за 5 лет.
ev_to_salesdoubleОтношение EV к выручке.

GetAssetReportsRequest

Запрос отчетов эмитентов

FieldTypeDescription
instrument_idstringИдентификатор инструмента в формате UID.
fromgoogle.protobuf.TimestampНачало запрашиваемого периода по UTC.
togoogle.protobuf.TimestampОкончание запрашиваемого периода по UTC.

GetAssetReportsResponse

Отчеты эмитентов

FieldTypeDescription
eventsМассив объектов GetAssetReportsResponse.GetAssetReportsEventМассив событий по облигации.

GetAssetReportsResponse.GetAssetReportsEvent

Отчет

FieldTypeDescription
instrument_idstringИдентификатор инструмента.
report_dategoogle.protobuf.TimestampДата публикации отчета.
period_yearint32Год периода отчета.
period_numint32Номер периода.
period_typeGetAssetReportsResponse.AssetReportPeriodTypeТип отчета.
created_atgoogle.protobuf.TimestampДата создания записи.

GetConsensusForecastsRequest

Запрос консенсус-прогнозов

FieldTypeDescription
pagingPageНастройки пагинации.

GetConsensusForecastsResponse

Консенсус-прогнозы

FieldTypeDescription
itemsМассив объектов GetConsensusForecastsResponse.ConsensusForecastsItemМассив прогнозов.
pagePageResponseДанные по пагинации.

GetConsensusForecastsResponse.ConsensusForecastsItem

Прогноз

FieldTypeDescription
uidstringUID-идентификатор.
asset_uidstringUID-идентификатор актива.
created_atgoogle.protobuf.TimestampДата и время создания записи.
best_target_priceQuotationЦелевая цена на 12 месяцев.
best_target_lowQuotationМинимальная прогнозная цена.
best_target_highQuotationМаксимальная прогнозная цена.
total_buy_recommendint32Количество аналитиков рекомендующих покупать.
total_hold_recommendint32Количество аналитиков рекомендующих держать.
total_sell_recommendint32Количество аналитиков рекомендующих продавать.
currencystringВалюта прогнозов инструмента.
consensusRecommendationКонсенсус-прогноз.
prognosis_dategoogle.protobuf.TimestampДата прогноза.

GetForecastRequest

Запрос прогнозов инвестдомов.

FieldTypeDescription
instrument_idstringИдентификатор инструмента.

GetForecastResponse

Прогнозы инвестдомов по инструменту.

FieldTypeDescription
targetsМассив объектов GetForecastResponse.TargetItemМассив прогнозов.
consensusGetForecastResponse.ConsensusItemСогласованный прогноз.

GetForecastResponse.TargetItem

Прогноз

FieldTypeDescription
uidstringУникальный идентификатор инструмента.
tickerstringТикер инструмента.
companystringНазвание компании, давшей прогноз.
recommendationRecommendationПрогноз.
recommendation_dategoogle.protobuf.TimestampДата прогноза.
currencystringВалюта.
current_priceQuotationТекущая цена.
target_priceQuotationПрогнозируемая цена.
price_changeQuotationИзменение цены.
price_change_relQuotationОтносительное изменение цены.
show_namestringНаименование инструмента.

GetForecastResponse.ConsensusItem

Консенсус-прогноз.

FieldTypeDescription
uidstringУникальный идентификатор инструмента.
tickerstringТикер инструмента.
recommendationRecommendationПрогноз.
currencystringВалюта.
current_priceQuotationТекущая цена.
consensusQuotationПрогнозируемая цена.
min_targetQuotationМинимальная цена прогноза.
max_targetQuotationМаксимальная цена прогноза.
price_changeQuotationИзменение цены.
price_change_relQuotationОтносительное изменение цены.

TradingInterval

FieldTypeDescription
typestringНазвание интервала.
intervalTradingInterval.TimeIntervalИнтервал.

TradingInterval.TimeInterval

FieldTypeDescription
start_tsgoogle.protobuf.TimestampВремя начала интервала.
end_tsgoogle.protobuf.TimestampВремя окончания интервала.

Enums

CouponType

Тип купонов.

NameNumberDescription
COUPON_TYPE_UNSPECIFIED0Неопределенное значение.
COUPON_TYPE_CONSTANT1Постоянный.
COUPON_TYPE_FLOATING2Плавающий.
COUPON_TYPE_DISCOUNT3Дисконт.
COUPON_TYPE_MORTGAGE4Ипотечный.
COUPON_TYPE_FIX5Фиксированный.
COUPON_TYPE_VARIABLE6Переменный.
COUPON_TYPE_OTHER7Прочее.

OptionDirection

Тип опциона по направлению сделки.

NameNumberDescription
OPTION_DIRECTION_UNSPECIFIED0Тип не определен.
OPTION_DIRECTION_PUT1Опцион на продажу.
OPTION_DIRECTION_CALL2Опцион на покупку.

OptionPaymentType

Тип расчетов по опциону.

NameNumberDescription
OPTION_PAYMENT_TYPE_UNSPECIFIED0Тип не определен.
OPTION_PAYMENT_TYPE_PREMIUM1Опционы с использованием премии в расчетах.
OPTION_PAYMENT_TYPE_MARGINAL2Маржируемые опционы.

OptionStyle

Тип опциона по стилю.

NameNumberDescription
OPTION_STYLE_UNSPECIFIED0Тип не определен.
OPTION_STYLE_AMERICAN1Американский опцион.
OPTION_STYLE_EUROPEAN2Европейский опцион.

OptionSettlementType

Тип опциона по способу исполнения.

NameNumberDescription
OPTION_EXECUTION_TYPE_UNSPECIFIED0Тип не определен.
OPTION_EXECUTION_TYPE_PHYSICAL_DELIVERY1Поставочный тип опциона.
OPTION_EXECUTION_TYPE_CASH_SETTLEMENT2Расчетный тип опциона.

InstrumentIdType

Тип идентификатора инструмента. Подробнее об идентификации инструментов.

NameNumberDescription
INSTRUMENT_ID_UNSPECIFIED0Значение не определено.
INSTRUMENT_ID_TYPE_FIGI1FIGI.
INSTRUMENT_ID_TYPE_TICKER2Ticker.
INSTRUMENT_ID_TYPE_UID3Уникальный идентификатор.
INSTRUMENT_ID_TYPE_POSITION_UID4Идентификатор позиции.

ShareType

Тип акций.

NameNumberDescription
SHARE_TYPE_UNSPECIFIED0Значение не определено.
SHARE_TYPE_COMMON1Обыкновенная.
SHARE_TYPE_PREFERRED2Привилегированная.
SHARE_TYPE_ADR3Американские депозитарные расписки.
SHARE_TYPE_GDR4Глобальные депозитарные расписки.
SHARE_TYPE_MLP5Товарищество с ограниченной ответственностью.
SHARE_TYPE_NY_REG_SHRS6Акции из реестра Нью-Йорка.
SHARE_TYPE_CLOSED_END_FUND7Закрытый инвестиционный фонд.
SHARE_TYPE_REIT8Траст недвижимости.

AssetType

Тип актива.

NameNumberDescription
ASSET_TYPE_UNSPECIFIED0Тип не определен.
ASSET_TYPE_CURRENCY1Валюта.
ASSET_TYPE_COMMODITY2Товар.
ASSET_TYPE_INDEX3Индекс.
ASSET_TYPE_SECURITY4Ценная бумага.

StructuredProductType

Тип структурной ноты.

NameNumberDescription
SP_TYPE_UNSPECIFIED0Тип не определен.
SP_TYPE_DELIVERABLE1Поставочный.
SP_TYPE_NON_DELIVERABLE2Беспоставочный.

EditFavoritesActionType

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

NameNumberDescription
EDIT_FAVORITES_ACTION_TYPE_UNSPECIFIED0Тип не определен.
EDIT_FAVORITES_ACTION_TYPE_ADD1Добавить в список.
EDIT_FAVORITES_ACTION_TYPE_DEL2Удалить из списка.

RealExchange

Реальная площадка исполнения расчетов.

NameNumberDescription
REAL_EXCHANGE_UNSPECIFIED0Тип не определен.
REAL_EXCHANGE_MOEX1Московская биржа.
REAL_EXCHANGE_RTS2Санкт-Петербургская биржа.
REAL_EXCHANGE_OTC3Внебиржевой инструмент.
REAL_EXCHANGE_DEALER4Инструмент, торгуемый на площадке брокера.

Recommendation

NameNumberDescription
RECOMMENDATION_UNSPECIFIED0Не определено.
RECOMMENDATION_BUY1Покупать.
RECOMMENDATION_HOLD2Держать.
RECOMMENDATION_SELL3Продавать.

RiskLevel

Уровень риска облигации.

NameNumberDescription
RISK_LEVEL_UNSPECIFIED0Не указан.
RISK_LEVEL_LOW1Низкий уровень риска.
RISK_LEVEL_MODERATE2Средний уровень риска.
RISK_LEVEL_HIGH3Высокий уровень риска.

BondType

NameNumberDescription
BOND_TYPE_UNSPECIFIED0Тип облигации не определен.
BOND_TYPE_REPLACED1Замещающая облигация.

InstrumentExchangeType

Площадка торговли.

NameNumberDescription
INSTRUMENT_EXCHANGE_UNSPECIFIED0Площадка торговли не определена.
INSTRUMENT_EXCHANGE_DEALER1Бумага, торгуемая у дилера.

GetBondEventsRequest.EventType

NameNumberDescription
EVENT_TYPE_UNSPECIFIED0Неопределенное значение.
EVENT_TYPE_CPN1Купон.
EVENT_TYPE_CALL2Опцион (оферта).
EVENT_TYPE_MTY3Погашение.
EVENT_TYPE_CONV4Конвертация.

GetAssetReportsResponse.AssetReportPeriodType

NameNumberDescription
PERIOD_TYPE_UNSPECIFIED0Не указан.
PERIOD_TYPE_QUARTER1Квартальный.
PERIOD_TYPE_SEMIANNUAL2Полугодовой.
PERIOD_TYPE_ANNUAL3Годовой.

InstrumentType

NameNumberDescription
INSTRUMENT_TYPE_UNSPECIFIED0Тип инструмента не определен
INSTRUMENT_TYPE_BOND1Облигация
INSTRUMENT_TYPE_SHARE2Акция
INSTRUMENT_TYPE_CURRENCY3Валюта
INSTRUMENT_TYPE_ETF4Exchange-traded fund
INSTRUMENT_TYPE_FUTURES5Фьючерс
INSTRUMENT_TYPE_SP6Структурная нота
INSTRUMENT_TYPE_OPTION7Опцион
INSTRUMENT_TYPE_CLEARING_CERTIFICATE8Clearing certificate
INSTRUMENT_TYPE_INDEX9Индекс
INSTRUMENT_TYPE_COMMODITY10Товар

InstrumentStatus

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

NameNumberDescription
INSTRUMENT_STATUS_UNSPECIFIED0Значение не определено.
INSTRUMENT_STATUS_BASE1По умолчанию — базовый список инструментов, которыми можно торговать через T-Invest API. Сейчас списки доступных бумаг в API и других интерфейсах совпадают — кроме внебиржевых бумаг, но в будущем списки могут различаться.
INSTRUMENT_STATUS_ALL2Список всех инструментов.

Execution

ValueDescription
EDExecution after Default - платеж выполнен после дефолта (должна быть дата платежа)
ETВыполнены обязательства по техническому дефолту (платеж выполнен после дефолта)
ESВыполнены обязательства по соглашению (платеж выполнен после соглашения)
SСоглашение
TТехнический дефолт
EExecution - исполнено, платеж выполнен без задержек
DDefault - дефолт
TDТехнически дефолт - задержка платежа более 5 дней, но менее 20

OperationType

EventTypeValueDescription
CPNОдно из значений: Прочий, Переменный, Фиксированный, Ипотечный, Дисконт, Плавающий, Постоянный
MTYCAЭмитент реализовал Call-опцион / частичное (амортизационное) погашение
MTYOACall-опциона нет или не реализован / частичное (амортизационное) погашение
MTYCMПолное погашение оставшегося номинала, OM - полное погашение оставшегося номинала
MTYCAЭмитент реализовал Call-опцион / частичное (амортизационное) погашение
CALLMДосрочное погашение облигаций по праву эмитента
CALLNДосрочное погашение облигаций по требованию владельцев
CALLCCall-опцион
CALLLCall опцион на период
CALLOОферта с возможностью дальнейшего обращения облигаций по требованию владельцев
CALLKВыкуп РЕПО
CALLAДосрочный выкуп облигаций по соглашению с их владельцами
CALLVДосрочное погашение ковенант
CONVпустоНе применимо

Нестандартные типы данных

MoneyValue

Денежная сумма в определенной валюте

FieldTypeDescription
currencystringСтроковый ISO-код валюты
unitsint64Целая часть суммы, может быть отрицательным числом
nanoint32Дробная часть суммы, может быть отрицательным числом

Quotation

Котировка - денежная сумма без указания валюты

FieldTypeDescription
unitsint64Целая часть суммы, может быть отрицательным числом
nanoint32Дробная часть суммы, может быть отрицательным числом

BrandData

Данные о бренде

FieldTypeDescription
logo_namestringЛоготип инструмента. Имя файла для получения логотипа
logo_base_colorstringЦвет бренда
text_colorstringЦвет текста для цвета логотипа бренда

openapi@tbank.ru

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