Тинькофф Инвестиции API: ИИ-агент для портфеля

Тинькофф Инвестиции API — публичный брокерский интерфейс: счета, инструменты, ордера, операции и котировки по gRPC и REST. Карточка для финансиста, который собирает отчётность по портфелю руками.

Агент — программа, которая делает дело целиком, а не отвечает на вопрос. Вы описываете задачу словами, он сам решает, что запросить и как свести результат. Три признака: работает в ваших сервисах, доводит до результата, работает без вас. Чат-бот подскажет метод, агент вернётся с готовым отчётом по операциям за период.

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

Документация описывает сервисы по частям: счета, инструменты, ордера, операции. Есть протоколы gRPC, WebSocket и Swagger, protobuf-файлы, SDK для Python, Java, C# и Golang, разделы про идентификацию торговых инструментов, порядок работы с историческими данными, дедлайны запросов и лимитную политику. Отдельно — торговые поручения, статусы инструментов и расписание торгов, работа с песочницей и раздел про алгоритмический трейдинг.

### Проверка платёжного календаря: где не сходится

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

### Остатки на счетах: сводка на утро

Агент читает счета и позиции и сводит утреннюю сводку: сколько денег, что в бумагах, что зарезервировано под заявки. Котировки берёт из сервиса, а не из памяти, и помечает позиции, по которым ответа не было. Сводка приходит одной таблицей, без обхода кабинета.

### Справки и сверка с бухгалтерией

Агент готовит справку по операциям за период: дата, инструмент, количество, сумма, комиссия. Расхождения с учётной системой выписывает построчно, с номером операции и разницей, и складывает пакет для бухгалтерии — с пометкой, где данных не хватило.

Решение о сделке, выставление поручения и оценка риска — за финансистом. Агент приносит данные и расчёты, но не торгует и не даёт инвестиционных рекомендаций.

Токен доступа выдаётся в кабинете брокера, работа начинается с песочницы: там те же методы, что в боевом контуре. Связь проверяется чтением списка счетов и позиций. Дальше агенту выдаются права ровно на нужные сервисы, а лимиты запросов сверяются с лимитной политикой из документации.

Не выставляет поручения и не выводит средства. Не обещает котировку в моменте: показывает время ответа сервиса. Не работает за пределами лимитов, описанных в политике API.

Что такое агент, если коротко? Программа, которая выполняет дело, а не отвечает на вопрос: сводит счета, операции и котировки в отчёт по портфелю. Чат-бот подскажет метод, агент принесёт готовую справку.

Что такое коннектор? Подключение Agenova к API по токену доступа: где его взять в кабинете, как проверить связь чтением счетов, какие сервисы разрешены. Не плагин, токен отзывается.

Зачем песочница, если есть боевой счёт? В песочнице те же методы, но без риска для денег: видно, как агент читает ответы, что делает с ошибками и как укладывается в лимиты. Боевой контур включается после проверки.