Описание

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

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

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

Для этого можно использовать два метода:

getOperationsByCursor — более предпочтительный для использования. Метод возвращает информацию обо всех операциях, в том числе отмененных, поддерживает пагинацию, расширенную фильтрацию и обладает всеми преимуществами метода getOperations.

Для вызова методов во входных параметрах достаточно указать account_ID.

Метод getOperations:

Не поддерживает опционы. Для получения информации по операциям с опционами используйте метод getOperationsByCursor.
Возвращает отмененные операции — параметр state. Учитывайте это в алгоритме работы.
Возвращает только последнюю тысячу операций.

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

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

При работе учитывайте особенности методов.

Получить портфолио

Чтобы торговый робот получал текущее состояние портфеля по счету, используйте метод getPortfolio.

Отличие метода от getPositions в том, что он возвращает статистическую информацию по портфелю — абсолютные и относительные доходности, текущую стоимость активов и другое.

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

Сейчас запросить портфолио по счету Инвесткопилки нельзя — type: ACCOUNT_TYPE_INVEST_BOX.

Особенности:

В методе есть булев параметр blocked — он принимает значение true, если инструмент заблокирован депозитарием.
Значения средних цен покупки инструментов рассчитываются асинхронно. Возможна задержка в пересчете до одной секунды. Параметры:
- average_position_price_pt;
- average_position_price — средневзвешенная цена позиции;
- average_position_price_fifo — средняя цена позиции по методу FIFO.

Подробнее о методах расчета с примерами

Получить список позиций портфеля по счету

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

В методе также возвращаются:

Тип инструмента для списка ценно-бумажных позиций портфеля — параметр instrument_type.
Булев параметр exchange_blocked — принимает значение true, если инструмент заблокирован депозитарием.
Массив опционов в портфеле.

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

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

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

Получить отчеты

В T-Invest API можно получать различные отчеты. Например, брокерский отчет или справку о доходах за пределами РФ.

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

Запрос справки о доходах за пределами РФ работает корректно, если верхний интервал запрашиваемых дат не позднее, чем 2 рабочих дня от текущей даты.

Стрим позиций и доходности портфеля

gRPC server-side stream PortfolioStream предназначен для получения информации об изменении портфеля по факту совершения сделок.

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

В валюте инструмента возвращаются:

средневзвешенная цена позиции,
текущая рассчитанная доходность,
текущая цена инструмента,
средняя цена лота в позиции по методу FIFO.

Для фьючерсов средняя цена лота в позиции возвращает количество в пунктах.

Стрим изменения позиций портфеля

gRPC server-side stream PositionsStream предназначен для получения информации по изменению позиций портфеля.

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

В качестве сообщений стрима приходят изменения позиций, объекты money, securities, futures, options и дата и время операции, изменившие позицию.

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

Также рекомендуем смотреть актуальную информацию по режимам и статусам торгов на сайтах Московской биржи и СПБ биржи.