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

Получить информацию о пользователе и его счетах в Тинькофф Инвестициях

Получить список счетов

В Тинькофф Инвестициях каждый пользователь может открывать несколько счетов, в том числе разных типов — брокерский, ИИС, инвесткопилка.

Чтобы получить список счетов, их статусы и типы, используйте метод getAccounts. Метод возвращает только те счета, к которым у вас есть доступ — заблокированные счета не выводятся. Если вы вызываете метод с токеном для одного счёта, возвращаются данные только по счёту, к которому выдан доступ токеном.

Получить текущие лимиты запросов

В Tinkoff Invest API есть система динамического назначения лимитов запросов для пользователя.

Подробнее про лимиты в Tinkoff Invest API

Чтобы получить информацию по лимитам для каждого метода сервиса Tinkoff Invest API и лимиты по stream-соединениям, используйте метод GetUserTariff.

Получить маржинальные показатели по счёту

В Tinkoff Invest API пользователи могут использовать маржинальную торговлю.

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

Подробнее о маржинальной торговле

Чтобы получить показатели маржинальной торговли, используйте метод getMarginAttributes. Он возвращает следующие параметры:

  • liquid_portfolio — стоимость плановых позиций активов, которые признаны ликвидными — то есть для которых определены ставки риска.
  • starting_margin — сумма модулей стоимостей плановых позиций активов, которые признаны ликвидными, умноженные на начальные ставки риска.
  • minimal_margin — сумма модулей стоимостей плановых позиций активов, которые признаны ликвидными, умноженные на минимальные ставки риска.
  • funds_sufficiency_level — уровень достаточности средств. Формула расчёта: (Стоимость портфеля − минимальная маржа) ÷ (Начальная маржа – минимальная маржа). Округляется до двух знаков после запятой.
  • amount_of_missing_funds — объём недостающих средств. Формула расчёта: starting_margin − liquid_portfolio.
  • corrected_Margin — начальная маржа, в которой плановые позиции рассчитываются с учётом активных заявок на покупку позиций лонг или продажу позиций шорт.

Получить информацию о статусе пользователя

Чтобы посмотреть различные атрибуты пользователя, можно использовать метод getInfo. С помощью него можно:

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