FAQ

Как мне найти Figi инструмента по его названию, тикеру или isin?

Что такое class_code и где его найти?

Как понять, что бумага доступна для торговли через TINKOFF INVEST API?

Что такое накопленный купонный доход облигации и как его узнать?

Как узнать стоимость шага цены (min_price_increment_amount) фьючерса?

Как узнать на какой бирже исполняются расчеты по инструменту?

Как найти базовый актив фьючерса?

Как отличить инструмент доступный для ИИС?

Как получить информацию об брендах?

Как по позиции найти инструмент?

Ставки риска и их коэфффиценты

Как узнать торгуется ли инструмент на выходных?

Какие заявки по опционам возможно выставить?

Что такое Figi инструмента?

FIGI(англ.: Financial Instrument Global Identifier) — глобальный идентификатор финансового инструмента. Представляет собой 12-символьный код из латинских букв и цифр, определяется как идентификатор ценной бумаги на торговой площадке (бирже), которая является некоторым "источником цен".

Нужно понимать, что не все инструменты, доступные в Тинькофф Инвестициях, имеют общепринятый Figi. Поэтому не гарантируется уникальность инструментов с другими источниками. Узнать актуальный Figi-идентификатор инструмента можно при помощи методов сервиса инструментов.

На данный момент основным идентификатором внутри Тинькофф Инвестиций является uid, который позволяет избежать возможной путаницы.

Как мне найти Figi инструмента по его названию, тикеру или isin?

Методы поиска инструментов по идентификатору (BondBy, CurrencyBy, EtfBy, FutureBy, ShareBy) позволяют получить информацию об инструменте зная его Figi или связку ticker + class_code. Если же эти идентификаторы вам неизвестны, вы можете получить полный список инструментов определённого типа методами запроса списков инструментов (Bonds, Currencies, Etfs, Futures, Shares) и выполнить поиск по известным параметрам самостоятельно. Сделать это можно в коде робота или при помощи любого доступного gRPC-клиента, например, Kreya. Инструкция по настройке Kreya доступна по ссылке.

Что такое class_code и где его найти?

Сlass_code — это технический параметр "Режим торгов", используемый для обозначения секции биржи, на которой торгуется данный инструмент. Узнать его можно, получив детали по инструменту методами сервиса инструментов.

Как понять, что бумага доступна для торговли через TINKOFF INVEST API?

Чтобы получить все доступные для торговли инструменты определённого типа можно воспользоваться соответствующими методами, передав параметр instrument_status = INSTRUMENT_STATUS_BASE: * Bonds * Currencies * Etfs * Futures * Shares

Если же нет необходимости получать полный список инструментов, можно использовать параметр api_trade_available_flag из ответа метода получения инструмента по его идентификатору (BondBy, CurrencyBy, EtfBy, FutureBy, ShareBy). Этот флаг отвечает за доступность инструмента для торгов через TINKOFF INVEST API.

Кроме того следует учитывать расписание работы бирж и торговый статус инструмента. Подробнее: Торговые статусы инструментов и расписание торгов.

Что такое накопленный купонный доход облигации и как его узнать?

Купон, или купонный доход — это процентные выплаты держателям облигаций со стороны эмитента, то есть компании или госоргана, выпустивших этот тип ценных бумаг. Даты выплат процентов по облигациям и размер купона известны заранее. Размер купона задается в процентах от номинала — то есть от цены облигации при ее выпуске. Величина купона может быть фиксированной или плавающей — то есть привязанной к инфляции, ключевой ставке Центробанка России или другим ориентирам. Иногда у облигации может вовсе не быть купона. Купонный доход по облигациям.

Получить календарь купонных выплат можно методом GetAccruedInterests.

Как узнать стоимость шага цены(min_price_increment_amount) фьючерса?

Данный параметр может изменяться довольно часто в течении дня, поэтому для его получения существует отдельный метод сервиса инструментов GetFuturesMargin.

Как узнать на какой бирже исполняются расчеты по инструменту?

Для определения биржи на которой исполняются расчеты по финансовому инструменту в TINKOFF INVEST API добавлен параметр real_exchange.

Список методов возвращающих в ответе биржу на которой исполняются расчеты:

GetInstrumentBy - Метод получения основной информации об инструменте.
GetBondBy - Метод получения облигации по её идентификатору.
GetBonds - Метод получения списка облигаций.
GetShareBy - Метод получения акции по её идентификатору.
GetShares - Метод получения списка акций.
GetEtfBy - Метод получения инвестиционного фонда по его идентификатору.
GetEtfs - Метод получения списка инвестиционных фондов.
GetFutureBy - Метод получения фьючерса по его идентификатору.
GetFutures - Метод получения списка фьючерсов.
GetCurrencyBy - Метод получения валюты по её идентификатору.
GetCurrencies - Метод получения списка валют.
GetOptionBy - Метод получения опциона по его идентификатору.
GetOptions - Метод получения опционов.

Как найти базовый актив фьючерса?

Используя метод FindInstrument можно найти базовый актив фьючерса. Для этого достаточно передать в query значение параметра basic_asset_position_uid, возвращаемое методами GetFutureBy и GetFutures.

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

Используя метод GetFavorites можно получить список избранных инструментов клиента. Данный метод может использоваться разработчиками для получения списка инструментов, которые робот добавил в избранное используя метод EditFavorites.

Для добавления или удаления инструментов из списка избранных можно использовать EditFavorites. Данный метод позволяет разработчикам автоматизировать выделение наиболее интересных инструментов путем редактирования списка избранных инструментов. Использование метода ограничено 100 инструментов. При попытке передать больше 100 инструментов будет возвращена ошибка "code":"30091" и "message":"quantity of instruments can't be more than 100".

Важно!!! Если вы хотите добавить в список избранных инструментов валюту, то это необходимо делать через валюту с лотностью = 1.
Инструменты валюты с разной лотностью имеют разные значения идентификаторов. Например,

FIGI доллара США с лотностью 1000 - TCS0013HGFT4, а FIGI доллара США с лотностью 1 - USD000UTSTOM.
FIGI евро с лотностью 1000 - BBG0013HJJ31, а FIGI доллара США с лотностью 1 - EUR000UTSTOM.

Как отличить инструмент доступный для ИИС?

В методах получения информации об инструментах добавлен флаг For_iis_flag принимающий булево значение в зависимости от доступности инструмента для ИИС.

Как получить информацию об активах?

В TINKOFF INVEST API представлены два метода для получения активов.

Используя метод getAssets сервиса инструментов можно получить список всех активов. Метод работает для всех инструментов, за исключением срочных - опционов и фьючерсов.

Используя метод getAssetBy сервиса инструментов можно найти актив по его идентификатору. Этот метод возвращает более подробную информацию о запрошенном активе. Набор данных отличается в зависимости от типа актива.

Как получить информацию об брендах?

В TINKOFF INVEST API представлены два метода для получения брендов.

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

Используя метод getBrandBy сервиса инструментов можно найти бренд по его идентификатору.

Как по позиции найти инструмент?

Для поиска инструмента по идентификатору позиции (Position_uid) добавлен тип идентификатора инструмента - INSTRUMENT_ID_TYPE_POSITION_UID.

Использовать id_type = INSTRUMENT_ID_TYPE_POSITION_UID можно методах:

GetInstrumentBy - Метод получения основной информации об инструменте.
GetBondBy - Метод получения облигации по её идентификатору.
GetShareBy - Метод получения акции по её идентификатору.
GetEtfBy - Метод получения инвестиционного фонда по его идентификатору.
GetFutureBy - Метод получения фьючерса по его идентификатору.
GetOptionBy - Метод получения опциона по его идентификатору.
GetCurrencyBy - Метод получения валюты по её идентификатору.

Ставки риска и их коэфффиценты

Чтобы лучше понять тему, вы можете ознакомиться с материалами, указанными в ссылках. Здесь же мы приведем лишь краткое определения и раскроем суть параметров.

Ставка риска — это показатель, который брокер использует для расчета суммы, которую вам нужно иметь на счете, чтобы открыть или поддерживать непокрытую позицию. Чем ниже ставка риска, тем крупнее может быть непокрытая позиция — то есть брокер будет готов одолжить больше активов. И наоборот — с высокой ставкой риска размер кредитного плеча в сделке будет небольшим или его не будет вовсе. Больше о ставках риска.

Стандартный и повышенный уровни риска. Клиенты российских брокеров — физические лица — делятся на две категории: клиенты со стандартным уровнем риска (КСУР) и клиенты с повышенным уровнем риска (КПУР). Клиентам со стандартным уровнем доступно меньшее кредитное плечо, чем КПУР.

Кредитное плечо — это беспроцентный заем, который брокер предоставляет инвестору для совершения сделок на более крупные суммы. Это соотношение между собственными средствами трейдера и заемными деньгами, предоставляемыми брокером или дилинговым центром на специальных условиях.

Начальная маржа — это стоимость всех ликвидных активов и фьючерсов в портфеле инвестора, приведенная к рублям по биржевому курсу и умноженная на ставки риска этих активов

Скорректированная маржа — это показатель, аналогичный начальной марже, но при этом учитывающий выставленные вами лимитные заявки на увеличение позиции (на любую покупку или на продажу в шорт).

Минимальная маржа — это половина от начальной или скорректированной маржи портфеля.

Лонг, или длинная позиция, — это сделка по покупке актива, когда инвестор ожидает роста его цены. Если инвесторы хотят заработать на растущем рынке, они торгуют в лонг. Как торговать в шорт?

Шорт или короткая позиция, - это сделка по продаже полученного в долг актива с целью через некоторое время выкупить его дешевле и заработать на разнице цен. Когда инвесторы хотят получить прибыль за счет снижения стоимости актива, они торгуют в шорт (также известен как «игра на понижение» или «непокрытая продажа»). Как торговать в шорт?

В методе сервиса инструментов в методах есть ряд параметров, связанных со ставками риска:

klong - Коэффициент ставки риска длинной позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР). 1 – клиент с повышенным уровнем риска (КПУР). kshort - Коэффициент ставки риска короткой позиции по клиенту. 2 – клиент со стандартным уровнем риска (КСУР). 1 – клиент с повышенным уровнем риска (КПУР). dlong - Ставка риска начальной маржи для КСУР лонг.
dshort - Ставка риска начальной маржи для КСУР шорт.
dlong_min - Ставка риска начальной маржи для КПУР лонг.
dshort_min - Ставка риска начальной маржи для КПУР шорт.

Коэффициенты маржинальной торговли появляются только на тех инструментах, которые были в перечне ликвидного имущества.

Как узнать торгуется ли инструмент на выходных?

Для отображения информации о возможности торговли инструментам по выходным добавлен флаг weekend_flag.

Какие заявки по опционам возможно выставить?

Торговля опционами через API в данный момент не доступна.

Что такое liquidity_flag?

Ликвидность — это способность быстро продать какой-то актив по рыночной цене, то есть без скидок. Чем быстрее это можно сделать, тем выше ликвидность актива.

Ликвидность инструмента на фондовом рынке оценивают по количеству совершаемых сделок (то есть по объему торгов) и величине спреда. Спред — это разница между максимальными ценами заявок на покупку и минимальными ценами заявок на продажу. Чем больше сделок и меньше разница, тем выше ликвидность.

Раз в полчаса брокер рассчитывает ликвидность по всем финансовым инструментом:

Для облигаций:

liquidity = ((Среднедневная цена * current_nominal)/100) * (Дневной объем торгов)

В остальных случаях:

liquidity = (Среднедневная цена) * (Дневной объем торгов)

На основе значения liqudity для разных типов финансовых инструментов устанавливается значение флага liquidity_flag, который принимает для значения:

true - инструмент считается ликвидным
false - инструмент не считается ликвидным