Т-Инвестиции

Приложение Т-Инвестиции подключает брокерский счёт к рабочему пространству Promto. Агент может анализировать портфель, позиции, операции, инструменты, стакан, свечи и заявки. С токеном живого контура он также может выставлять и отменять реальные биржевые заявки после явного подтверждения.

Подключение

1. Откройте настройки API Т-Инвестиций.
2. Выпустите токен для нужного контура:

• боевой — реальные счета и заявки;
• песочница Т-Инвестиций — учебные операции без реальных денег.

1. Сохраните токен: он показывается один раз.
2. В Promto откройте приложение Т-Инвестиции и нажмите Подключить.
3. Вставьте токен и включите отметку учебного контура, если токен создан для него.
4. Дождитесь проверки через список доступных счетов.

Одновременно к рабочему пространству подключается один токен. Подключать и отключать его может только владелец. Токен хранится на сервере и не передаётся агенту.

Интерфейс приложения

На главном экране доступны сценарии:

• Портфель — состав, стоимость и результат по позициям;
• Котировки и стакан — поиск инструмента и текущие рыночные данные;
• Операции — движения по счёту за период;
• Подключение — переход к вводу токена.

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

Работа с агентом

Основной агент использует инструмент promto_tinvest. Это встроенный инструмент чата; отдельной одноимённой команды в терминале нет.

Задача	Действия инструмента
Счета и портфель	list_accounts, get_portfolio, get_positions
История	list_operations
Инструменты и рынок	search_instruments, get_orderbook, get_candles
Заявки	list_orders, place_order, cancel_order
Дополнительный метод API	request

Начинайте со list_accounts: у владельца может быть несколько брокерских счетов. Для следующих запросов передавайте выбранный account_id; агрегирование между счетами агент делает отдельно.

Денежные значения API приходят как {units, nano}. Корректная величина равна units + nano / 1 000 000 000. Попросите агента показывать валюту и не трактовать nano как копейки.

Практические сценарии

Сводка портфеля

Агент покажет состав портфеля, доли и текущую оценку. Если счетов несколько, сначала согласуйте, анализировать один счёт или объединённую картину.

Проверка инструмента

Сначала агент находит инструмент и его идентификатор, затем запрашивает стакан или свечи. Укажите интервал, период и желаемую глубину стакана.

Сверка операций

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

Подготовка заявки

Попросите рассчитать параметры, но сначала оставить заявку черновиком в ответе. Для реального вызова агент должен показать все параметры и дождаться недвусмысленного согласия.

Ограничения и безопасность

• Рыночная стоимость и стакан отражают момент запроса и могут измениться до следующего сообщения.
• Интеграция работает с брокерскими счетами. Она не управляет текущим банковским счётом, переводами или платёжными поручениями.
• Токен только для чтения не позволит выставить или отменить заявку — это ожидаемое ограничение прав.
• place_order и cancel_order требуют params.confirm=true, которое агент добавляет только после вашего явного подтверждения.
• Учебный и живой токены нельзя смешивать. Режим в приложении должен соответствовать выпущенному токену.
• Результат анализа не является индивидуальной инвестиционной рекомендацией. Проверяйте риск и условия сделки самостоятельно.

Если не работает

Симптом	Что проверить
Нет доступных счетов	Правильный ли контур выбран и есть ли счёт у токена
Счёт не найден	Сначала повторить list_accounts и использовать фактический account_id
Операция записи отклонена	Разрешает ли токен торговые операции и было ли явное подтверждение
Неверная сумма	Проверить преобразование {units, nano} и валюту
Котировка отличается	Зафиксировать время запроса: рыночные данные меняются
Ошибка авторизации	Выпустить новый токен и переподключить интеграцию в правильном режиме

Связанные материалы

• Настройки рабочего пространства
• Как получать лучший результат

Готовый промпт

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