Перейти к содержанию

FAQ

Что такое 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 и где его найти?

class_code — это технический параметр «Режим торгов». Используется для обозначения секции биржи, на которой торгуется инструмент.

Чтобы его узнать, получите детали по инструменту через методы сервиса инструментов.

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

Чтобы получить все доступные для торговли инструменты определённого типа, передайте параметр instrument_status = INSTRUMENT_STATUS_BASE в нужном методе:

Если вам не нужно получать полный список инструментов, используйте параметр api_trade_available_flag из ответа методов получения инструмента по его идентификатору — BondBy, CurrencyBy, EtfBy, FutureBy, ShareBy. Он отвечает за доступность инструмента для торгов через Tinkoff Invest API.

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

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

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

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

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

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

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

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

В Tinkoff Invest API есть параметр real_exchange — он передаётся для определения биржи, на которой исполняются расчёты по финансовому инструменту.

Список методов:

  • GetInstrumentBy — получить основную информацию об инструменте.
  • BondBy — получить облигацию по её идентификатору.
  • Bonds — получить список облигаций.
  • ShareBy — получить акцию по её идентификатору.
  • Shares — получить список акций.
  • EtfBy — получить инвестиционный фонд по его идентификатору.
  • Etfs — получить список инвестиционных фондов.
  • FutureBy — получить фьючерс по его идентификатору.
  • Futures — получить список фьючерсов.
  • CurrencyBy — получить валюту по её идентификатору.
  • Currencies — получить список валют.
  • OptionBy — получить опцион по его идентификатору.
  • Options — получить опционы.

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

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

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

  • Список избранных инструментов можно получить через метод GetFavorites — в ответе возвращаются инструменты, которые робот добавил в избранное через метод EditFavorites.

  • Добавить или удалить инструменты из списка избранных можно через метод EditFavorites. С помощью него можно автоматизировать выделение наиболее интересных инструментов через редактирование списка избранных инструментов.

    Ограничение на использование метода — 100 инструментов. Если вы передадите больше 100 инструментов, вернётся ошибка с кодом 30091 и сообщением quantity of instruments can't be more than 100.

Важно

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

У позиции (валюты) есть разные инструменты, которыми можно торговать. Например, у доллара это могут быть инструменты с лотностью в 1 доллар или 1000 долларов.

Примеры идентификаторов:

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

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

В методах для получения информации об инструментах есть флаг for_iis_flag — он принимает булевое значение в зависимости от доступности инструмента для ИИС.

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

В Tinkoff Invest API есть два метода для получения активов:

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

    • Идентификатор.
    • Тип актива.
    • Название актива.
    • Массив инструментов актива.

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

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

В Tinkoff Invest API есть два метода для получения брендов:

  1. Brands — получить список всех брендов.

  2. BrandBy — найти бренд по его идентификатору.

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

Для поиска инструмента по идентификатору позиции (position_uid) есть тип идентификатора инструмента — INSTRUMENT_ID_TYPE_POSITION_UID.

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

  • InstrumentBy — получить основную информацию об инструменте.
  • BondBy — получить облигацию по её идентификатору.
  • ShareBy — получить акцию по её идентификатору.
  • EtfBy — получить инвестиционный фонд по его идентификатору.
  • FutureBy — получить фьючерс по его идентификатору.
  • OptionBy — получить опцион по его идентификатору.
  • CurrencyBy — получить валюту по её идентификатору.

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

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

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

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

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

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

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

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

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

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

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

  • klong — коэффициент ставки риска длинной позиции по клиенту:

    • 2 — клиент со стандартным уровнем риска (КСУР);
    • 1 — клиент с повышенным уровнем риска (КПУР).

  • kshort — коэффициент ставки риска короткой позиции по клиенту:

    • 2 – клиент со стандартным уровнем риска (КСУР);
    • 1 – клиент с повышенным уровнем риска (КПУР).

  • dlong — ставка риска начальной маржи для КСУР лонг.

  • dshort — ставка риска начальной маржи для КСУР шорт.
  • dlong_min — ставка риска начальной маржи для КПУР лонг.
  • dshort_min — ставка риска начальной маржи для КПУР шорт.

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

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

В методах инстурментов есть флаг weekend_flag:

  • true — инструмент торгуется;
  • false — инструмент не торгуется.

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

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

Что такое liquidity_flag?

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

Ликвидность инструмента на фондовом рынке оценивают по количеству совершаемых сделок — то есть по объёму торгов — и величине спреда.

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

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

  • Для облигаций — liquidity = ((Среднедневная цена * current_nominal)/100) * (Дневной объём торгов).
  • В остальных случаях — liquidity = (Среднедневная цена) * (Дневной объём торгов).

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

  • true — инструмент считается ликвидным;
  • false — инструмент не считается ликвидным.

Корпоративные действия и изменение идентификатора инструмента

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

Некоторые корпоративные действия приводят к изменению инструмента и его параметров на бирже — новый тикер, изменение лотности, шага цены, стоимости. После таких событий:

  • создаётся новый инструмент с новыми идентификаторами — FIGI, UID;
  • позиция переносится на новый инструмент;
  • операции начинают проводиться по созданному инструменту;
  • старый инструмент помечается удалённым и становится недоступен в API;
  • исторические данные по инструменту, который существовал до корпоративного действия, больше недоступны.

Как скачать логотип компании?

В методах GetBondBy, GetBonds, GetShareBy, GetShares, GetEtfBy, GetEtfs, GetFutureBy, GetFutures, GetCurrencyBy, GetCurrencies есть информация о бренде, в том числе логотип компании.

Чтобы скачать логотип, сформируйте запрос вида https://invest-brands.cdn-tinkoff.ru/<logoName<size>.png>, где <logoName<size>.png> — логотип компании с размерами в точках. Доступные размеры — 160x, 320x, 640x.

Пример

Логотип компании TCS Group — US87238U20333.png. Запрос будет одним из следующих:

Размер логотипа Запрос
160x https://invest-brands.cdn-tinkoff.ru/US87238U20333x160.png
320x https://invest-brands.cdn-tinkoff.ru/US87238U20333x320.png
640x https://invest-brands.cdn-tinkoff.ru/US87238U20333x640.png