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

Идентификация торговых инструментов

Для точного определения торговых инструментов используются разные идентификаторы:

  1. Isin (International Security Identification Number) — международный идентификационный номер ценной бумаги. Состоит из 12 символов цифр и латинских букв, которые обычно начинаются с 2-буквенного кода страны эмитента ценной бумаги.

    Структура ISIN
    Первые два символа — буквы, определяющие код страны эмитента согласно стандарту ISO 3166-1 — например, российские ISIN-коды начинаются буквами RU.
    Далее — 9 букв и цифр национального идентификационного кода ценной бумаги (National Securities Identifying Number, NSIN). Завершает код контрольная цифра. Например, ISIN акции TCS Group — US87238U2033.

  2. Ticker — краткое (1–5 букв) наименование ценной бумаги на конкретной бирже. Без указания биржи и режима торгов это просто набор букв — поэтому на российских биржах MOEX и SPBE используется специальный признак «Режим торгов», который соответствует техническому термину class_code. Комбинация тикера и class_code является уникальным идентификатором, только тикер — нет.
    Например, тикер TCS Group — TCSG.

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

    Обратите внимание: FIGI, присваемые в Т-Инвестициях, не всегда совпадают с международным классификатором. Это устаревший параметр, который не рекомендуется использовать.

Идентификаторы из модели финансовых инструментов Т-Инвестиций

В Т-Инвестициях применяется иерархическая система идентификации финансовых объектов.

Бренд

На верхнем уровне находится бренд — работающая на финансовом рынке компания, которая является эмитентом ценных бумаг. Пример бренда — Сбербанк.

Актив

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

Позиция

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

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

Торговый инструмент

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

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

Параметры в API

  • uid бренда — идентификатор компании;
  • asset_uid — идентификатор актива;
  • position_uid — идентификатор позиции;
  • instrument_uid — идентификатор торгового инструмента.

Instrument_Id

Для удобства клиентов, которые в своих системах использовали устаревший идентификатор FIGI, в большинстве методов T-Invest API предусмотрено универсальное поле Instrument_Id — в нём можно передавать как FIGI, так и instrument_uid.

Вы можете получить идентификаторы конкретного инструмента через метод FindInstrument, передав в параметре query известный идентификатор или название инструмента.

Сейчас при передаче значения в параметре Instrument_Id сначала выполняется поиск инструмента по instrument_uid, потом — по FIGI.

Основной идентификатор торгового инструмента при работе с T-Invest API — UID, так как, например, в опционах идентификатор FIGI не поддерживается.